<!-- source_url: https://docs.mynexusapi.com/v1/guias/catalogos | last_updated: 2026-11-19 -->

# Catálogos

Los códigos del SRI que lleva la Estructura del comprobante, con el campo donde va cada uno y las reglas que valida la API.

Muchos campos del comprobante no admiten texto libre, sino un código del SRI: el
tipo de identificación del comprador, la tarifa de IVA, la forma de pago o el
código de retención. Aquí tienes esos códigos en tablas, en qué campo va cada
uno y qué reglas comprueba la API antes de aceptar el comprobante.

Los catálogos que cambian con la normativa, como las tarifas, las formas de pago
o los tipos de identificación, también los puedes leer desde la API, como se
explica en [Consultar los catálogos por API](#consultar-los-catalogos-por-api).
Las tablas de esta página son la referencia legible y la API es la fuente que
tu sistema puede consultar para mantenerse al día. Los términos del dominio,
como [RUC](/v1/guias/glosario), [retención](/v1/guias/glosario) o
[sustento](/v1/guias/glosario), están explicados en el
[Glosario](/v1/guias/glosario).

## Consultar los catálogos por API

Puedes leer los catálogos del SRI directamente desde la API para llenar listas
desplegables, validar un código antes de emitir o enterarte de una tarifa nueva
sin esperar a que cambie tu sistema. La consulta no consume cupo y se hace en
dos pasos: primero listas los catálogos disponibles y después lees el detalle
del que necesitas.

| Operación | Ruta | Qué devuelve |
|---|---|---|
| Listar catálogos | `GET /v1/catalogos` | La clave y una descripción breve de cada catálogo. |
| Leer un catálogo | `GET /v1/catalogos/{nombre}` | Las filas del catálogo con su código, descripción y, según el catálogo, su valor, su vigencia y atributos propios. |

Ambas operaciones requieren la cabecera `X-Api-Key`, no llevan cuerpo y
responden con `Cache-Control: private, max-age=3600`. Los catálogos cambian
pocas veces al año, así que puedes guardar la respuesta hasta una hora.

### Catálogos disponibles

`nombre` es la clave que devuelve `GET /v1/catalogos`. Estos son los catálogos
publicados:

| Clave | Contenido | Dónde se usa |
|---|---|---|
| `tipos-comprobante` | Tipos de comprobante electrónico y su código. | [Tipos de comprobante](#tipos-de-comprobante) |
| `tipos-identificacion` | Tipos de identificación del comprador, proveedor, transportista o sujeto retenido. | [Tipos de identificación](#tipos-de-identificacion) |
| `impuestos` | Códigos de impuesto de los comprobantes con importes. | [Impuestos](#impuestos) |
| `tarifas-iva` | Valores de `codigoPorcentaje` para el IVA y su tarifa en porcentaje. | [Tarifas de IVA](#tarifas-de-iva) |
| `formas-pago` | Formas de pago de `pagos[].formaPago`. | [Formas de pago](#formas-de-pago) |
| `retencion-iva` | Códigos de retención de IVA y su porcentaje. | [Códigos de retención de IVA](#codigos-de-retencion-de-iva) |
| `retencion-isd` | Códigos de retención del impuesto a la salida de divisas (ISD), con su porcentaje y vigencia. | [Retenciones y sustento](#retenciones-y-sustento) |
| `ambientes` | Tipos de ambiente de emisión. | [Tipo de emisión y ambiente](#tipo-de-emision-y-ambiente) |
| `tipos-emision` | Tipos de emisión. | [Tipo de emisión y ambiente](#tipo-de-emision-y-ambiente) |
| `restricciones` | Tipo, longitud, patrón y decimales de los campos del comprobante según los XSD del SRI. | [Límites](/v1/guias/limites#estructura-del-comprobante) |

### Ejemplo

> [!IMPORTANT]
> Ambiente de pruebas: sin validez fiscal.

El ejemplo lee el detalle del catálogo `tarifas-iva`. Para listar todos los
catálogos, llama a `GET /v1/catalogos` sin el último segmento de la ruta.

```bash
curl -s "https://api-sandbox.mynexusapi.com/v1/catalogos/tarifas-iva" \
  -H "X-Api-Key: $ECUAFACT_API_KEY"
```

```csharp
using System.Net.Http;

string apiKey = Environment.GetEnvironmentVariable("ECUAFACT_API_KEY")!;
using var http = new HttpClient { BaseAddress = new Uri("https://api-sandbox.mynexusapi.com") };
http.DefaultRequestHeaders.Add("X-Api-Key", apiKey);

using HttpResponseMessage respuesta = await http.GetAsync("/v1/catalogos/tarifas-iva");
Console.WriteLine($"{(int)respuesta.StatusCode} {await respuesta.Content.ReadAsStringAsync()}");
```

```javascript
// Node.js 18 o superior. Guarda como catalogos.mjs y ejecuta: node catalogos.mjs
const res = await fetch('https://api-sandbox.mynexusapi.com/v1/catalogos/tarifas-iva', {
  headers: { 'X-Api-Key': process.env.ECUAFACT_API_KEY }
});
console.log(res.status, await res.text());
```

```php
<?php
$ch = curl_init('https://api-sandbox.mynexusapi.com/v1/catalogos/tarifas-iva');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-Api-Key: ' . getenv('ECUAFACT_API_KEY')],
]);
$cuerpo = curl_exec($ch);
$estado = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
echo $estado . ' ' . $cuerpo . PHP_EOL;
```

```bash-cli
# Resultado esperado: la tabla de códigos del catálogo, con su descripción y valor.
ecuafact catalogos tarifas-iva --entorno sandbox
```

La respuesta de `GET /v1/catalogos` es el índice:

```json
{
  "catalogos": [
    {
      "nombre": "tipos-comprobante",
      "descripcion": "Tipos de comprobante electrónico y su código codDoc."
    },
    {
      "nombre": "tarifas-iva",
      "descripcion": "Valores de codigoPorcentaje para el IVA y su tarifa en porcentaje."
    }
  ]
}
```

| Campo | Tipo | Descripción |
|---|---|---|
| `catalogos` | array | Los catálogos disponibles, en el orden de la ficha técnica del SRI. |
| `catalogos[].nombre` | string | Clave del catálogo; es el valor que va en la ruta de detalle. |
| `catalogos[].descripcion` | string | Descripción breve de lo que contiene. |

La respuesta de `GET /v1/catalogos/{nombre}` es el detalle:

```json
{
  "nombre": "tarifas-iva",
  "descripcion": "Valores de codigoPorcentaje para el IVA y su tarifa en porcentaje.",
  "fuente": "Ficha técnica SRI 2.34, Tabla 17",
  "items": [
    {
      "codigo": "0",
      "descripcion": "0 %",
      "valor": 0
    },
    {
      "codigo": "4",
      "descripcion": "15 %",
      "valor": 15
    }
  ]
}
```

| Campo | Tipo | Descripción |
|---|---|---|
| `nombre` | string | Clave del catálogo. |
| `descripcion` | string | Descripción breve del catálogo. |
| `fuente` | string | Tabla o anexo de la ficha técnica del SRI de donde proviene. |
| `items` | array | Las filas del catálogo. |
| `items[].codigo` | string | Código tal como va en el comprobante. Envíalo como texto, con sus ceros a la izquierda cuando los tenga. |
| `items[].descripcion` | string | Descripción del código. |
| `items[].valor` | number | Valor numérico asociado, por ejemplo la tarifa en porcentaje. Se omite si el catálogo no lo tiene. |
| `items[].vigenteDesde` | string | Primer día de vigencia, en formato `yyyy-MM-dd`. Se omite si la fila no está acotada por el inicio. |
| `items[].vigenteHasta` | string | Último día de vigencia, en formato `yyyy-MM-dd`. Se omite si la fila sigue vigente. |
| `items[].atributos` | objeto | Atributos propios del catálogo, por ejemplo la raíz del XML en `tipos-comprobante`. Se omite si no hay. |

Un mismo `codigo` puede aparecer en varias filas con vigencias distintas, como
ocurre con los códigos de retención del ISD. Elige la fila cuya vigencia cubre
la fecha de tu comprobante.

### Estados de este endpoint

| Código | HTTP | Cuándo ocurre | Qué hacer |
|---|---|---|---|
| 3009 (`credenciales_invalidas`) | 401 | Falta `X-Api-Key` o la API Key es inválida, está revocada o venció. | Revisa la cabecera y la API Key, como se explica en [Autenticación](/v1/guias/autenticacion). |
| 3010 (`ip_no_autorizada`) | 403 | En producción, la IP de origen no está registrada para tu integración. | Registra tu IP pública en el Portal del Cliente. |
| 3013 (`no_encontrado`) | 404 | `GET /v1/catalogos/{nombre}` no encuentra un catálogo con esa clave. | Lista los catálogos con `GET /v1/catalogos` y usa una clave de la lista. |
| 5005 (`limite_solicitudes`) | 429 | Superaste las solicitudes por minuto de tu integración. | Espera los segundos que indica `Retry-After` y repite la consulta. |
| 5002 (`servicio_no_disponible`) | 503 | Los catálogos no están disponibles por un momento. | Espera los segundos que indica `Retry-After` y repite la consulta. |

## Emisión

### Tipos de comprobante

Estos son los códigos de tipo de comprobante. El tipo lo fija la ruta de emisión
que llamas, así que el cuerpo no lleva `infoTributaria.tipoDocumento`. En las
respuestas y en los filtros de consulta, el tipo se identifica con
`tipoDocumento`. Los códigos también se usan en `info.codDocModificado`, en las
notas de crédito y débito, para indicar el tipo del documento modificado.

| Código | Comprobante | Ruta de emisión | Guía |
|---|---|---|---|
| `01` | Factura | `POST /v1/contribuyentes/{identificacion}/facturas` | [Factura](/v1/guias/emision-01) |
| `03` | Liquidación de compra de bienes y prestación de servicios | `POST /v1/contribuyentes/{identificacion}/liquidaciones-compra` | [Liquidación de compra](/v1/guias/emision-03) |
| `04` | Nota de crédito | `POST /v1/contribuyentes/{identificacion}/notas-credito` | [Nota de crédito](/v1/guias/emision-04) |
| `05` | Nota de débito | `POST /v1/contribuyentes/{identificacion}/notas-debito` | [Nota de débito](/v1/guias/emision-05) |
| `06` | Guía de remisión | `POST /v1/contribuyentes/{identificacion}/guias-remision` | [Guía de remisión](/v1/guias/emision-06) |
| `07` | Comprobante de retención | `POST /v1/contribuyentes/{identificacion}/retenciones` | [Comprobante de retención](/v1/guias/emision-07) |

Que tu API Key pueda emitir un tipo depende de los tipos habilitados para tu integración. Los tipos habilitados
aparecen en `tiposComprobante` de [`GET /v1/contexto`](/v1/guias/consulta-contexto).

### Tipos de identificación

Estos códigos van en `tipoIdentificacionComprador` (factura y notas),
`tipoIdentificacionProveedor` (liquidación de compra),
`tipoIdentificacionTransportista` (guía) y `tipoIdentificacionSujetoRetenido`
(retención). Con cualquier otro código, la API responde 422.

| Código | Tipo | Regla de la identificación |
|---|---|---|
| `04` | RUC | 13 dígitos. |
| `05` | Cédula | 10 dígitos. |
| `06` | Pasaporte | Hasta 20 caracteres. |
| `07` | Venta a consumidor final | Identificación `9999999999999`. Solo en factura y con `importeTotal` de hasta 50.00. |
| `08` | Identificación del exterior | Hasta 20 caracteres. |

Además, cada tipo de comprobante tiene sus propias restricciones:

| Comprobante | Restricción |
|---|---|
| Factura (`01`) | Admite `07` solo si `importeTotal` es 50.00 o menos. Por encima, identifica al comprador con `04`, `05`, `06` u `08`. |
| Liquidación, notas de crédito y débito, retención | No admiten `07`, porque el receptor debe estar identificado. |
| Guía de remisión | El destinatario no lleva tipo, y `identificacionDestinatario` debe tener 10 dígitos (cédula) o 13 (RUC). |

### Impuestos

El código del impuesto va en `impuestos[].codigo` y `totalConImpuestos[].codigo`
en los comprobantes con importes, y en
`impuestosDocSustento[].codImpuestoDocSustento` en la retención.

| Código | Impuesto | Soportado por la API |
|---|---|---|
| `2` | IVA | Sí. Cada detalle lleva exactamente un IVA. |
| `3` | ICE | Sí, solo el ICE porcentual y como máximo uno por detalle. La nota de débito y la liquidación de compra no admiten ICE. |
| `5` | IRBPNR | No. Un detalle con IRBPNR recibe un 422. |

### Tarifas de IVA

Estos son los valores de `codigoPorcentaje` cuando `codigo` es `2` (IVA). La
`tarifa` que envías es el porcentaje, es decir, `15` y no `0.15`.

| codigoPorcentaje | Tarifa | `tarifa` que envías | Uso |
|---|---|---|---|
| `0` | 0 % | `0` | Bienes y servicios gravados con tarifa 0 %. |
| `4` | 15 % | `15` | Tarifa general vigente. |
| `5` | 5 % | `5` | Tarifa reducida (por ejemplo, materiales de construcción). |
| `6` | No objeto de impuesto | `0` | Operaciones que no son objeto de IVA. |
| `7` | Exento de IVA | `0` | Operaciones exentas. |
| `8` | 8 % (diferenciado) | `8` | Tarifa diferenciada que fija el SRI para periodos específicos (por ejemplo, feriados turísticos). |
| `2` | 12 % | `12` | Tarifa del SRI para operaciones de los periodos fiscales en que rige el 12 %. |
| `3` | 14 % | `14` | Tarifa del SRI para operaciones de los periodos fiscales en que rige el 14 %. |
| `10` | 13 % | `13` | Tarifa especial publicada por el SRI. |

El catálogo del SRI incluye códigos de periodos anteriores: su presencia no
determina que correspondan a la fecha y operación que estás facturando.

La API valida estas reglas y, si alguna no se cumple, responde 422:

- El `codigoPorcentaje` es uno de la tabla anterior y la `tarifa` es la que
  corresponde a ese código. Con otro código, la API responde 422.
- La `tarifa` admite 2 decimales como máximo y no supera 99.99.
- Con `codigoPorcentaje` en `0`, `6` o `7`, la `tarifa` es 0.
- Con cualquier otro `codigoPorcentaje`, la `tarifa` es mayor que 0.
- El `valor` es (`cantidad` x `precioUnitario` - `descuento`) x `tarifa` / 100,
  calculado sobre la base **sin redondear** y redondeado a 2 decimales al final.
  Como `baseImponible` reporta la base ya redondeada, `baseImponible` x
  `tarifa` / 100 puede diferir en un centavo. El ejemplo y el detalle están en
  [Cómo calcular los totales](/v1/guias/emision#como-calcular-los-totales).
- La base del IVA incluye el ICE de la misma línea, si lo hay.
- En la cabecera (`totalConImpuestos`), la `tarifa` es opcional, pero si la
  envías debe coincidir con la de los detalles del mismo `codigoPorcentaje`.

### Tarifas de ICE

Estos son los valores de `codigoPorcentaje` cuando `codigo` es `3` (ICE). El SRI
publica un código de hasta 4 dígitos por cada producto gravado, como
cigarrillos, bebidas alcohólicas, vehículos o perfumes, y los actualiza con
frecuencia. La `tarifa` no se publica: debes determinar el porcentaje aplicable
al producto y fecha antes de emitir.

La API solo admite el ICE **porcentual**, cuyo `valor` es la base de la línea x
`tarifa` / 100, y ese valor se suma a la base del IVA de la misma línea. El ICE
de tarifa específica, que es un valor fijo por unidad, no está soportado.

### Formas de pago

Estos son los códigos de `pagos[].formaPago`, de 2 dígitos.

| Código | Forma de pago |
|---|---|
| `01` | Sin utilización del sistema financiero (efectivo) |
| `15` | Compensación de deudas |
| `16` | Tarjeta de débito |
| `17` | Dinero electrónico |
| `18` | Tarjeta prepago |
| `19` | Tarjeta de crédito |
| `20` | Otros con utilización del sistema financiero (transferencia, cheque) |
| `21` | Endoso de títulos |

Cualquier otro código responde 422. Cada comprobante con pagos lleva de 1 a 20 formas de pago, y la suma de
`pagos[].total` debe ser igual al total del comprobante. Si `plazo` es mayor que
0, `unidadTiempo` es obligatoria, como se explica en
[Unidades de tiempo](#unidades-de-tiempo).

### Retenciones y sustento

Estos son los códigos del [Comprobante de retención](/v1/guias/emision-07). El
impuesto retenido va en `retenciones[].codigo`:

| `codigo` | Impuesto retenido | Base de la retención | Tabla de `codigoRetencion` |
|---|---|---|---|
| `1` | Impuesto a la renta | Base sin IVA de la compra | [Códigos de retención de renta](#codigos-de-retencion-de-renta) |
| `2` | IVA | Valor del IVA de la compra | [Códigos de retención de IVA](#codigos-de-retencion-de-iva) |
| `6` | Impuesto a la salida de divisas (ISD) | Valor pagado | `4580` (hasta abril de 2025) o `4586` (2.5 %, desde mayo de 2025) |

Con cualquier otro `codigo`, la API responde 422. `codigoRetencion` admite
hasta 5 caracteres (letras, dígitos y `- _ . : /`). `porcentajeRetener` admite
2 decimales como máximo y 3 dígitos en total: `100`, `70`, `10.5` y `2.75` son
válidos y `12.75` responde 422. La API comprueba que `valorRetenido` sea
`baseImponible` x `porcentajeRetener` / 100, redondeado a 2 decimales. En IVA
(`codigo` `2`) comprueba además que el código exista y que el porcentaje
corresponda al código; en ISD (`codigo` `6`) comprueba que el código sea `4580`
o `4586`. En renta (`codigo` `1`) **no** comprueba que el porcentaje
corresponda al código: si no corresponde, el SRI puede no autorizar el
comprobante.

### Códigos de retención de IVA

Estos son los valores de `retenciones[].codigoRetencion` cuando `codigo` es `2`.

| codigoRetencion | Porcentaje (`porcentajeRetener`) |
|---|---|
| `9` | 10 |
| `10` | 20 |
| `1` | 30 |
| `11` | 50 |
| `2` | 70 |
| `3` | 100 |
| `7` | 0 (retención en cero) |
| `8` | 0 (no procede retención) |

### Códigos de retención de renta

Estos son valores de `retenciones[].codigoRetencion` cuando `codigo` es `1`. El
SRI mantiene una tabla extensa que actualiza por resolución, así que aquí solo
están las filas de uso frecuente con su porcentaje de referencia. Antes de usar
un código, confirma el porcentaje en la tabla vigente del SRI.

| codigoRetencion | Concepto | Porcentaje de referencia |
|---|---|---|
| `303` | Honorarios profesionales y demás pagos por servicios relacionados con el título profesional | 10 |
| `307` | Servicios en los que predomina la mano de obra | 2 |
| `310` | Transporte privado de pasajeros o servicio público o privado de carga | 1 |
| `312` | Transferencia de bienes muebles de naturaleza corporal | 1.75 |
| `320` | Arrendamiento de bienes inmuebles | 10 |
| `322` | Seguros y reaseguros (primas y cesiones) | 1.75 |
| `332` | Pagos de bienes o servicios no sujetos a retención | 0 |
| `343` | Otras retenciones aplicables el 1 % | 1 |
| `3440` | Otras retenciones aplicables el 2.75 % | 2.75 |

La API no admite los códigos de banano `338`, `340`, `341`, `342`, `342A` y
`342B`, que reciben un 422.

### Códigos de sustento

`docsSustento[].codSustento` indica para qué usas la compra en tu contabilidad
tributaria. Estas son las filas de uso frecuente:

| codSustento | Descripción | Admitido |
|---|---|---|
| `01` | Crédito tributario para declaración de IVA (servicios y bienes distintos de inventarios y activos fijos) | Sí |
| `02` | Costo o gasto para declaración de impuesto a la renta (servicios y bienes distintos de inventarios y activos fijos) | Sí |
| `03` | Activo fijo: crédito tributario para declaración de IVA | Sí |
| `04` | Activo fijo: costo o gasto para declaración de impuesto a la renta | Sí |
| `05` | Liquidación de gastos de viaje, hospedaje y alimentación | Sí |
| `06` | Inventario: crédito tributario para declaración de IVA | Sí |
| `07` | Inventario: costo o gasto para declaración de impuesto a la renta | Sí |
| `10` | Distribución de dividendos, beneficios o utilidades | No (422) |

### Tipos de documento de sustento

`docsSustento[].codDocSustento` indica el tipo del documento del proveedor sobre
el que retienes. Estas son las filas de uso frecuente:

| codDocSustento | Documento | Admitido |
|---|---|---|
| `01` | Factura | Sí |
| `02` | Nota o boleta de venta | Sí |
| `03` | Liquidación de compra de bienes y prestación de servicios | Sí |
| `04` | Nota de crédito | Sí |
| `05` | Nota de débito | Sí |
| `41` | Comprobante de venta emitido por reembolso | No (422) |

El documento de sustento sigue estas reglas:

| Campo | Regla |
|---|---|
| `numDocSustento` | Lleva 15 dígitos sin guiones (`001001000000123`), aunque también se acepta `ddd-ddd-ddddddddd`. |
| `numAutDocSustento` | Es opcional. Si lo envías, es el número de autorización del sustento, de 10 a 49 dígitos (49 en un sustento electrónico: su clave de acceso). |
| `pagoLocExt` | Vale `01` (pago local), porque el pago al exterior no está soportado. |

## Estados

### Estado de la operación

Estos son los valores de `estado` en
[`GET /v1/operaciones/{idOperacion}`](/v1/guias/consulta-operacion) y en el cuerpo
de los [webhooks](/v1/guias/webhooks#campos-del-cuerpo). Todos son finales
salvo `recibido`.

| Estado | Significado | Final |
|---|---|---|
| `recibido` | Recibimos el comprobante, pasó nuestras validaciones y todavía no tiene un resultado final. Espera el webhook o consulta más tarde, sin reenviarlo. | No |
| `autorizado` | El SRI autorizó el comprobante. Es el único valor con validez fiscal. | Sí |
| `rechazado` | El comprobante no se autorizó por su contenido, porque lo rechazó el SRI o porque no cumplió una regla de la validación fiscal. Corrígelo según `codEstado` y `errores` y emítelo de nuevo. | Sí |
| `rechazo_configuracion` | No se pudo emitir porque falta o está mal una configuración del emisor, como la firma electrónica o el cupo. Corrige la configuración y reenvíalo. | Sí |
| `error` | No se pudo emitir por un fallo inesperado o porque algo impidió de forma definitiva su autorización. Lo que debes hacer depende de `codEstado`. | Sí |
| `cancelado` | La plataforma canceló el envío de forma automática. El comprobante no se emitió y no consumió cupo. | Sí |

No llames "autorizado" a un comprobante recibido, porque el 202 de la emisión
solo indica que fue **recibido**.

### Códigos de resultado

Cada `estado` viene acompañado de un `codEstado`, un número de 4 dígitos cuyo
primer dígito es el propio `estado`. Con `recibido` el código es 1001, o 1002 si
el comprobante ya tiene `claveAcceso`, y con `autorizado` es 2001; en esos casos
`msgError` no viene y `errores` es una lista vacía. Cuando el `estado` es otro,
el `codEstado` dice la causa, `msgError` la describe con un texto fijo y
`errores` trae el detalle cuando existe. Qué hacer ante cada código se explica en
[Errores](/v1/guias/errores#codigos-de-resultado-de-una-operacion).

| `codEstado` | `estado` | Significado |
|---|---|---|
| 1001 (`comprobante_recibido`) | `recibido` | Recibimos el comprobante y todavía no tiene `claveAcceso`. |
| 1002 (`comprobante_enviado`) | `recibido` | Recibimos el comprobante y ya tiene `claveAcceso`, pero aún no hay resultado del SRI. |
| 2001 (`comprobante_autorizado`) | `autorizado` | El SRI autorizó el comprobante. |
| 3001 (`rechazo_sri`) | `rechazado` | El SRI rechazó el comprobante. `errores` trae el mensaje del SRI. |
| 3002 (`comprobante_invalido`) | `rechazado` | La validación fiscal rechazó el contenido antes de enviarlo al SRI. `errores` trae el detalle por campo cuando existe. |
| 4001 (`emisor_no_configurado`) | `rechazo_configuracion` | Al emisor le falta configuración para emitir ante el SRI. |
| 4002 (`firma_no_valida`) | `rechazo_configuracion` | La firma electrónica del emisor está caducada o no es válida. |
| 4003 (`suscripcion_inactiva`) | `rechazo_configuracion` | El servicio de emisión de tu cuenta no está activo en este ambiente. |
| 4004 (`cupo_agotado`) | `rechazo_configuracion` | No quedan documentos en tus paquetes vigentes. |
| 5006 (`entrega_no_posible`) | `error` | El comprobante no se pudo emitir y confirmamos que no se creó. |
| 5007 (`resultado_no_confirmado`) | `error` | No pudimos confirmar si el comprobante llegó a crearse. |
| 5001 (`error_interno`) | `error` | Tuvimos un fallo inesperado. |
| 6001 (`operacion_cancelada`) | `cancelado` | La plataforma canceló el envío y no consumió cupo. |

### Estado SRI de procesamiento

Son las siglas que usa el SRI en sus propios servicios y portales. La API no las
devuelve, sino que las resume en `estado`, pero te sirven si comparas con lo
que ves en el portal del SRI.

| Sigla | Significado | Equivale a `estado` |
|---|---|---|
| `PPR` | En procesamiento | `recibido` |
| `AUT` | Autorizado | `autorizado` |
| `NAT` | No autorizado | `rechazado`, con `codEstado` 3001 |

Un comprobante en `PPR` todavía no está autorizado, así que espera a `AUT`.

## Otras tablas

### Tipo de emisión y ambiente

No envíes `tipoEmision` ni `ambiente` en la Estructura del comprobante, porque
la API responde 422. Usamos siempre la emisión normal (`tipoEmision`
`1`) y el ambiente de la URL que llamas, como se explica en
[Ambientes](/v1/guias/ambientes). Los dos códigos aparecen dentro de la clave
de acceso; el del ambiente, en la posición 24:

| Ambiente | URL base | Código SRI |
|---|---|---|
| Pruebas | `https://api-sandbox.mynexusapi.com` | `1` |
| Producción | `https://api.mynexusapi.com` | `2` |

### Unidades de tiempo

`pagos[].unidadTiempo` es texto libre de hasta 20 caracteres y es obligatoria
cuando `plazo` es mayor que 0. Si la omites con `plazo` en 0, usamos
`dias`. Los valores habituales son `dias`, `meses` y `anios`.

### Monedas

`info.moneda` admite `DOLAR` o `USD`, y con cualquier otro valor la API responde
422. Si el campo es obligatorio o no depende del comprobante:

| Comprobante | `moneda` |
|---|---|
| Factura, liquidación de compra, nota de crédito | Obligatoria |
| Nota de débito | Opcional |
| Guía de remisión, retención | No se envía (422) |

### Países (comercio exterior)

`paisOrigen`, `paisDestino` y `paisAdquisicion`, en la factura de exportación,
usan el código numérico de tres dígitos del catálogo de países del SRI. El de
Ecuador es `593`. La tabla reproduce el catálogo de países del SRI.

| Código | Descripción |
|---|---|
| 016 | AMERICAN SAMOA |
| 074 | BOUVET ISLAND |
| 101 | ARGENTINA |
| 102 | BOLIVIA |
| 103 | BRASIL |
| 104 | CANADA |
| 105 | COLOMBIA |
| 106 | COSTA RICA |
| 107 | CUBA |
| 108 | CHILE |
| 109 | ANGUILA |
| 110 | ESTADOS UNIDOS |
| 111 | GUATEMALA |
| 112 | HAITI |
| 113 | HONDURAS |
| 114 | JAMAICA |
| 115 | MALVINAS ISLAS |
| 116 | MEXICO |
| 117 | NICARAGUA |
| 118 | PANAMA |
| 119 | PARAGUAY |
| 120 | PERU |
| 121 | PUERTO RICO |
| 122 | REPUBLICA DOMINICANA |
| 123 | EL SALVADOR |
| 124 | TRINIDAD Y TOBAGO |
| 125 | URUGUAY |
| 126 | VENEZUELA |
| 127 | CURAZAO |
| 129 | BAHAMAS |
| 130 | BARBADOS |
| 131 | GRANADA |
| 132 | GUYANA |
| 133 | SURINAM |
| 134 | ANTIGUA Y BARBUDA |
| 135 | BELICE |
| 136 | DOMINICA |
| 137 | SAN CRISTOBAL Y NEVIS |
| 138 | SANTA LUCIA |
| 139 | SAN VICENTE Y LAS GRANAD. |
| 140 | ANTILLAS HOLANDESAS |
| 141 | ARUBA |
| 142 | BERMUDA |
| 143 | GUADALUPE |
| 144 | GUYANA FRANCESA |
| 145 | ISLAS CAIMAN |
| 146 | ISLAS VIRGENES (BRITANICAS) |
| 147 | JOHNSTON ISLA |
| 148 | MARTINICA |
| 149 | MONTSERRAT ISLA |
| 151 | TURCAS Y CAICOS ISLAS |
| 152 | VIRGENES, ISLAS (NORT.AMER.) |
| 201 | ALBANIA |
| 202 | ALEMANIA |
| 203 | AUSTRIA |
| 204 | BELGICA |
| 205 | BULGARIA |
| 207 | ALBORAN Y PEREJIL |
| 208 | DINAMARCA |
| 209 | ESPANA |
| 211 | FRANCIA |
| 212 | FINLANDIA |
| 213 | REINO UNIDO |
| 214 | GRECIA |
| 215 | PAISES BAJOS (HOLANDA) |
| 216 | HUNGRIA |
| 217 | IRLANDA |
| 218 | ISLANDIA |
| 219 | ITALIA |
| 220 | LUXEMBURGO |
| 221 | MALTA |
| 222 | NORUEGA |
| 223 | POLONIA |
| 224 | PORTUGAL |
| 225 | RUMANIA |
| 226 | SUECIA |
| 227 | SUIZA |
| 228 | CANARIAS ISLAS |
| 229 | UCRANIA |
| 230 | RUSIA |
| 231 | YUGOSLAVIA |
| 233 | ANDORRA |
| 234 | LIECHTENSTEIN |
| 235 | MONACO |
| 237 | SAN MARINO |
| 238 | VATICANO (SANTA SEDE) |
| 239 | GIBRALTAR |
| 241 | BELARUS |
| 242 | BOSNIA Y HERZEGOVINA |
| 243 | CROACIA |
| 244 | ESLOVENIA |
| 245 | ESTONIA |
| 246 | GEORGIA |
| 247 | GROENLANDIA |
| 248 | LETONIA |
| 249 | LITUANIA |
| 250 | MOLDOVA |
| 251 | MACEDONIA |
| 252 | ESLOVAQUIA |
| 253 | ISLAS FAROE |
| 260 | FRENCH SOUTHERN TERRITORIES |
| 301 | AFGANISTAN |
| 302 | ARABIA SAUDITA |
| 303 | MYANMAR (BURMA) |
| 304 | CAMBOYA |
| 306 | COREA NORTE |
| 307 | TAIWAN (CHINA) |
| 308 | FILIPINAS |
| 309 | INDIA |
| 310 | INDONESIA |
| 311 | IRAK |
| 312 | IRAN (REPUBLICA ISLAMICA) |
| 313 | ISRAEL |
| 314 | JAPON |
| 315 | JORDANIA |
| 316 | KUWAIT |
| 317 | LAOS, REP. POP. DEMOC. |
| 318 | LIBANO |
| 319 | MALASIA |
| 321 | MONGOLIA (MANCHURIA) |
| 322 | PAKISTAN |
| 323 | SIRIA |
| 325 | TAILANDIA |
| 327 | BAHREIN |
| 328 | BANGLADESH |
| 329 | BUTAN |
| 330 | COREA DEL SUR |
| 331 | CHINA POPULAR |
| 332 | CHIPRE |
| 333 | EMIRATOS ARABES UNIDOS |
| 334 | QATAR |
| 335 | MALDIVAS |
| 336 | NEPAL |
| 337 | OMAN |
| 338 | SINGAPUR |
| 339 | SRI LANKA (CEILAN) |
| 341 | VIETNAM |
| 342 | YEMEN |
| 343 | ISLAS HEARD Y MCDONALD |
| 344 | BRUNEI DARUSSALAM |
| 346 | TURQUIA |
| 347 | AZERBAIJAN |
| 348 | KAZAJSTAN |
| 349 | KIRGUIZISTAN |
| 350 | TAJIKISTAN |
| 351 | TURKMENISTAN |
| 352 | UZBEKISTAN |
| 353 | PALESTINA |
| 354 | HONG KONG |
| 355 | MACAO |
| 356 | ARMENIA |
| 382 | MONTENEGRO |
| 402 | BURKINA FASO |
| 403 | ARGELIA |
| 404 | BURUNDI |
| 405 | CAMERUN |
| 406 | CONGO |
| 407 | ETIOPIA |
| 408 | GAMBIA |
| 409 | GUINEA |
| 410 | LIBERIA |
| 412 | MADAGASCAR |
| 413 | MALAWI |
| 414 | MALI |
| 415 | MARRUECOS |
| 416 | MAURITANIA |
| 417 | NIGERIA |
| 419 | ZIMBABWE (RHODESIA) |
| 420 | SENEGAL |
| 421 | SUDAN |
| 422 | SUDAFRICA (CISKEI) |
| 423 | SIERRA LEONA |
| 425 | TANZANIA |
| 426 | UGANDA |
| 427 | ZAMBIA |
| 429 | BENIN |
| 430 | BOTSWANA |
| 431 | REPUBLICA CENTROAFRICANA |
| 432 | COSTA DE MARFIL |
| 433 | CHAD |
| 434 | EGIPTO |
| 435 | GABON |
| 436 | GHANA |
| 437 | GUINEA-BISSAU |
| 438 | GUINEA ECUATORIAL |
| 439 | KENIA |
| 440 | LESOTHO |
| 441 | MAURICIO |
| 442 | MOZAMBIQUE |
| 443 | MAYOTTE |
| 444 | NIGER |
| 445 | RWANDA |
| 446 | SEYCHELLES |
| 447 | SAHARA OCCIDENTAL |
| 448 | SOMALIA |
| 449 | SANTO TOME Y PRINCIPE |
| 450 | SWAZILANDIA |
| 451 | TOGO |
| 452 | TUNEZ |
| 453 | ZAIRE |
| 454 | ANGOLA |
| 456 | CABO VERDE |
| 458 | COMORAS |
| 459 | DJIBOUTI |
| 460 | NAMIBIA |
| 463 | ERITREA |
| 464 | MOROCCO |
| 465 | REUNION |
| 466 | SANTA ELENA |
| 499 | JERSEY |
| 501 | AUSTRALIA |
| 503 | NUEVA ZELANDA |
| 504 | SAMOA OCCIDENTAL |
| 506 | FIJI |
| 507 | PAPUA NUEVA GUINEA |
| 508 | TONGA |
| 509 | PALAO (BELAU) ISLAS |
| 510 | KIRIBATI |
| 511 | MARSHALL ISLAS |
| 512 | MICRONESIA |
| 513 | NAURU |
| 514 | SALOMON ISLAS |
| 515 | TUVALU |
| 516 | VANUATU |
| 517 | GUAM |
| 518 | ISLAS COCOS (KEELING) |
| 519 | ISLAS COOK |
| 520 | ISLAS NAVIDAD |
| 521 | MIDWAY ISLAS |
| 522 | NIUE ISLA |
| 523 | NORFOLK ISLA |
| 524 | NUEVA CALEDONIA |
| 525 | PITCAIRN, ISLA |
| 526 | POLINESIA FRANCESA |
| 529 | TIMOR DEL ESTE |
| 530 | TOKELAI |
| 531 | WAKE ISLA |
| 532 | WALLIS Y FUTUNA, ISLAS |
| 590 | SAINT BARTHELEMY |
| 593 | ECUADOR |
| 594 | AGUAS INTERNACIONALES |
| 595 | ALTO VOLTA |
| 596 | BIELORRUSIA |
| 597 | COTE D'IVOIRE |
| 598 | CYPRUS |
| 599 | REPUBLICA CHECA |
| 600 | FALKLAND ISLANDS |
| 601 | LATVIA |
| 602 | LIBIA |
| 603 | NORTHERN MARIANA ISL |
| 604 | ST. PIERRE AND MIQUE |
| 605 | SYRIAN ARAB REPUBLIC |
| 606 | TERRITORIO ANTARTICO BRITANICO |
| 607 | TERRITORIO BRITANICO OCEANO IN |
| 688 | SERBIA |
| 831 | GUERNSEY |
| 832 | JERSEY |
| 833 | ISLE OF MAN |

## Siguientes pasos

- [Factura](/v1/guias/emision-01): aplica los códigos de identificación, IVA y formas de pago en tu primer comprobante.
- [Comprobante de retención](/v1/guias/emision-07): usa los códigos de retención y sustento con un ejemplo calculado.
- [Glosario](/v1/guias/glosario): significado de los términos fiscales de esta página.
