1. Lista de valores
API de Facturación Aliaddo NITRO
  • Introducción
  • Autenticación
  • Códigos de respuesta de la API
  • Facturas electrónicas
    • Crear factura electrónica
      POST
    • Crear factura sector salud
      POST
    • Crear factura divisas
      POST
    • Consultar por ID
      GET
    • Consultar por prefijo y consecutivo
      GET
  • Documentos soporte
    • Crear documento soporte
      POST
    • Consultar por ID
      GET
    • Consultar por prefijo y consecutivo
      GET
  • Documentos equivalentes
    • Crear tiquete P.O.S
    • Crear tiquete de transporte terrestre
    • Crear tiquete de cine
    • Crear tiquete de cobro de peajes
    • Crear tiquete aereo
    • Crear boleta de ingreso a espectáculos públicos
    • Consultar por ID
    • Consultar por prefijo y consecutivo
  • Notas crédito
    • Crear nota crédito
    • Consultar por ID
    • Consultar por prefijo y consecutivo
  • Notas débito
    • Crear nota débito
    • Consultar por ID
    • Consultar por prefijo y consecutivo
  • Nota de ajuste al documento soporte
    • Crear nota de ajuste
    • Consultar por ID
    • Consultar por prefijo y consecutivo
  • Nota crédito al documento equivalente
    • Crear nota crédito al documento equivalente
    • Consultar por ID
    • Consultar por prefijo y consecutivo
  • Nota débito al documento equivalente
    • Crear nota débito al documento equivalente
    • Consultar por ID
    • Consultar por prefijo y consecutivo
  • Nota de ajuste al documento equivalente
    • Crear nota de ajuste al documento equivalente
  • Lista de valores
    • Actividades económicas
    • Ciudades
    • Códigos de monedas
    • Código estandar del producto
    • Condiciones de entrega (INCOTERMS)
    • Departamentos
    • Medios de pagos
    • Paises
    • Responsabilidades fiscales
    • Tipos de identificacion
    • Tipos de documentos electrónicos
    • Tipos de operación
    • Tipos de persona
    • Tipos de regimen
    • Tributos (Impuestos/Retenciones)
    • Unidades de cantidad
    • Responsable de impuestos
    • Códigos Postales de Colombia
  • Estructura de datos
    • Ancho del PDF
    • Descuentos y cargos
    • Direcciones del cliente
    • Documentos equivalentes
    • Extensiones de facturas
    • Factura electrónica de venta
    • Factura electrónica sector salud
    • Factura electrónica de venta y compra de divisas
    • Formatos permitidos PDF
    • ID set de pruebas DIAN
    • Modo contingencia
    • Modos de ambiente de facturación
    • Notas de ajuste débito y crédito al documento equivalente
    • Notas crédito y débito de factura electrónica de venta
  • Guía para importar archivos
    • Introducción
  • Schemas
    • Documentos electrónicos
      • FacturaElectronica
      • Divisas
      • DocumentoSoporteRequest
      • DocumentoEquivalenteRequest
      • BoletaEspectaculosRequest
    • Impuestos
    • Mandante
    • Retencioness
    • Resolución Pos
    • FacturaRequestPOS
    • FacturaRequest
    • Supplier
    • Dirección
    • Resolución
    • Cliente
    • Productos
    • LineaProductoPeaje
    • Totales
    • SectorSalud
    • Transporte
    • Sucursal
    • RequestResponse
    • Cinema
    • TikectAereo
    • EspectaculoPublico
    • ComprayVentaDeDivisas
    • Retenciones
    • Descuento
    • Propinas
    • Cargos
    • Supplier2
    • NotasCred/Deb/Ajus
  1. Lista de valores

Paises

Esta guía te indica cómo enviar correctamente el país en la API usando el estándar ISO 3166-1.

1. Qué debes enviar#

En el JSON debes usar estos campos:
countryCode: código ISO 3166-1 alfa-2 de 2 letras.
countryName: nombre del país.
Ejemplo mínimo:
{
  "countryCode": "CO",
  "countryName": "Colombia"
}

2. Regla simple para no fallar#

1.
Usa en countryCode un valor ISO alfa-2 en mayúscula.
2.
Envía en countryName el nombre del país correspondiente.
3.
Asegura que countryCode y countryName coincidan entre sí.

3. Códigos ISO 3166-1 más usados#

countryCodecountryName
COColombia
USEstados Unidos
MXMéxico
ARArgentina
CLChile
PEPerú
ECEcuador
PAPanamá
BRBrasil
ESEspaña

4. Ejemplos rápidos#

Cliente en Colombia:
{
  "countryCode": "CO",
  "countryName": "Colombia"
}
Cliente en Estados Unidos:
{
  "countryCode": "US",
  "countryName": "Estados Unidos"
}
Cliente en México:
{
  "countryCode": "MX",
  "countryName": "México"
}

5. Validaciones recomendadas en la API#

Rechaza countryCode vacío o nulo.
Valida que countryCode tenga exactamente 2 letras mayúsculas.
Valida que el código exista en ISO 3166-1 alfa-2.
Rechaza inconsistencias entre countryCode y countryName.

6. Errores comunes#

Enviar countryCode con 3 letras, por ejemplo COL, cuando debes enviar alfa-2, por ejemplo CO.
Enviar countryCode en minúscula, por ejemplo co.
Enviar countryName que no corresponde al código.
Enviar solo countryName sin countryCode.

7. Checklist antes de enviar#

countryCode está informado y en formato ISO alfa-2.
countryName está informado.
El código y el nombre corresponden al mismo país.
Modificado en 2026-03-11 15:51:50
Anterior
Medios de pagos
Siguiente
Responsabilidades fiscales
Built with