Capacidades y catálogos de un país
curl --request GET \
--url https://api.filexpress.app/api/external/v2/countries/{code} \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.filexpress.app/api/external/v2/countries/{code}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.filexpress.app/api/external/v2/countries/{code}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.filexpress.app/api/external/v2/countries/{code}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"status": true,
"data": {
"country_code": "GT",
"name": "Guatemala",
"legal_currency": "GTQ",
"base_currency_of_business": "USD",
"timezone": "America/Guatemala",
"document_types": [
{
"code": "fact",
"name": "Factura",
"number_code": "01",
"applicable_to": "both",
"requires": []
}
],
"payment_methods": [
{
"id": "9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11",
"code": "01",
"name": "Efectivo"
}
],
"taxes": [
{
"id": "3b8e2f10-7c4d-4a9e-b1f2-5d6c7e8f9a01",
"name": "IVA",
"number_code": "20",
"tax_type": "percentage",
"percent": 12,
"effect": "add"
}
],
"tax_rules": [],
"identification_types": [],
"adapter": {
"signs": false,
"async": false,
"void_mode": "cancel",
"supports_draft": true,
"supports_skip_transmission": false,
"country_data_schema": {
"fcam": {
"periodos": {
"type": "integer",
"required": false,
"default": 1,
"description": "Número de periodos (>= 1)."
}
}
}
}
}
}{
"status": false,
"message": "Invalid API Key."
}{
"status": false,
"message": "This integration does not have the 'countries' permission.",
"required_scope": "countries"
}{
"status": false,
"code": "country_not_supported",
"message": "No hay facturación electrónica configurada para el país XX."
}{
"status": false,
"message": "Rate limit exceeded. Please try again later.",
"rate_limit": 100
}Capacidades y catálogos de un país
Tipos de documento, formas de pago, impuestos, reglas de impuestos y capacidades de facturación de un país, para armar documentos sin código específico por país. base_currency_of_business es la moneda base del negocio de la integración. Solo lee catálogos del país pedido; nunca datos de otros negocios. Responde 404 country_not_supported si no hay facturación electrónica configurada para el país.
Permiso requerido: countries
GET
/
v2
/
countries
/
{code}
Capacidades y catálogos de un país
curl --request GET \
--url https://api.filexpress.app/api/external/v2/countries/{code} \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.filexpress.app/api/external/v2/countries/{code}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.filexpress.app/api/external/v2/countries/{code}"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.filexpress.app/api/external/v2/countries/{code}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}{
"status": true,
"data": {
"country_code": "GT",
"name": "Guatemala",
"legal_currency": "GTQ",
"base_currency_of_business": "USD",
"timezone": "America/Guatemala",
"document_types": [
{
"code": "fact",
"name": "Factura",
"number_code": "01",
"applicable_to": "both",
"requires": []
}
],
"payment_methods": [
{
"id": "9d1c5a3e-4b7f-4e2a-9c1d-2f6b8a0e7c11",
"code": "01",
"name": "Efectivo"
}
],
"taxes": [
{
"id": "3b8e2f10-7c4d-4a9e-b1f2-5d6c7e8f9a01",
"name": "IVA",
"number_code": "20",
"tax_type": "percentage",
"percent": 12,
"effect": "add"
}
],
"tax_rules": [],
"identification_types": [],
"adapter": {
"signs": false,
"async": false,
"void_mode": "cancel",
"supports_draft": true,
"supports_skip_transmission": false,
"country_data_schema": {
"fcam": {
"periodos": {
"type": "integer",
"required": false,
"default": 1,
"description": "Número de periodos (>= 1)."
}
}
}
}
}
}{
"status": false,
"message": "Invalid API Key."
}{
"status": false,
"message": "This integration does not have the 'countries' permission.",
"required_scope": "countries"
}{
"status": false,
"code": "country_not_supported",
"message": "No hay facturación electrónica configurada para el país XX."
}{
"status": false,
"message": "Rate limit exceeded. Please try again later.",
"rate_limit": 100
}Authorizations
API Key de la integración (Integraciones → Nueva Integración).
Path Parameters
Código ISO-2 del país (no distingue mayúsculas).
Required string length:
2