Catalogos
Tablas de referencia del SRI usadas por la API, agrupadas por donde se aplican. El mismo contenido, en JSON, esta en Catalogos.
Emision#
Tipos de comprobante#
Codigos de infoTributaria.codDoc.
| codDoc | Comprobante | Soportado |
|---|---|---|
01 |
Factura | Si |
03 |
Liquidacion de compra | Si |
04 |
Nota de credito | Si |
05 |
Nota de debito | Si |
06 |
Guia de remision | Si |
07 |
Comprobante de retencion | Si |
Tipos de identificacion#
Codigos de tipoIdentificacionComprador, tipoIdentificacionProveedor,
tipoIdentificacionTransportista y tipoIdentificacionSujetoRetenido.
| Codigo | Tipo |
|---|---|
04 |
RUC |
05 |
Cedula |
06 |
Pasaporte |
07 |
Venta a consumidor final |
08 |
Identificacion del exterior |
Notas: consumidor final usa 9999999999999; la liquidacion no recibe consumidor
final; notas de credito/debito y retencion requieren identificar al receptor.
Impuestos#
Codigo de impuesto (impuestos[].codigo, totalConImpuestos[].codigo):
| Codigo | Impuesto | Soportado |
|---|---|---|
2 |
IVA | Si |
3 |
ICE | Si (porcentual) |
5 |
IRBPNR | No soportado |
IVA (codigoPorcentaje):
| Tarifa | codigoPorcentaje |
|---|---|
| 0% | 0 |
| 12% | 2 |
| 14% | 3 |
| 15% (general vigente) | 4 |
| 5% | 5 |
| No objeto de impuesto | 6 |
| Exento de IVA | 7 |
| IVA diferenciado | 8 |
| 13% | 10 |
ICE: codigoPorcentaje segun la Tabla 18 (ej. 3011, 3021, 3053, 3081,
3101, 3491, 3720-3726). ISD: 4580 (5%).
La tarifa de totalConImpuestos, si llega, debe coincidir con la del detalle.
Formas de pago#
Codigos de pagos[].formaPago:
| Codigo | Forma de pago |
|---|---|
01 |
Sin utilizacion del sistema financiero |
15 |
Compensacion de deudas |
16 |
Tarjeta de debito |
17 |
Dinero electronico |
18 |
Tarjeta prepago |
19 |
Tarjeta de credito |
20 |
Otros con utilizacion del sistema financiero |
21 |
Endoso de titulos |
Retenciones y sustento#
IVA retenido (retenciones[].codigoRetencion; codigo = 2):
| Retencion | Codigo | Porcentaje |
|---|---|---|
| IVA 10% | 9 |
10 |
| IVA 20% | 10 |
20 |
| IVA 30% | 1 |
30 |
| IVA 50% | 11 |
50 |
| IVA 70% | 2 |
70 |
| IVA 100% | 3 |
100 |
Renta (codigoRetencion), principales: 303 honorarios, 312 mano de obra,
320 compras de bienes, 322/323 servicios, 324/325 entre sociedades,
327A arrendamiento, 329 seguros, 332D/332E transporte privado, 344A
otras, 346 estandarizado.
Sustento:
| Campo | Regla |
|---|---|
codDocSustento |
Tipo del documento (el 41 se rechaza) |
codSustento |
Codigo de sustento (el 10 se rechaza) |
numDocSustento |
15 digitos, sin guiones |
numAutDocSustento |
Sustento electronico de 49 digitos |
Estados#
Estado de la operacion#
Valores de GET /v1/operaciones/{id} en estado.
| Estado | Significado |
|---|---|
en_cola |
Registrada, aun no enviada |
enviando |
En despacho |
enviado |
Enviado para procesamiento fiscal |
resultado_desconocido |
El resultado aun no se confirma |
cancelado |
Operacion cancelada |
desconocido |
Estado no reconocido |
Estado de autorizacion#
Valores de estadoAutorizacion en listados y operacion.
| Valor | Significado |
|---|---|
no_disponible |
Aun sin resultado fiscal |
pendiente |
En procesamiento por el SRI |
autorizado |
El SRI autorizo el comprobante |
error |
El SRI rechazo el comprobante |
desconocido |
Estado no reconocido |
Estado SRI de procesamiento#
Siglas del SRI; la API las resume en estadoAutorizacion.
| Sigla | Significado |
|---|---|
PPR |
En procesamiento |
AUT |
Autorizado |
NAT |
No autorizado |
Un codigo de procesamiento intermedio del SRI (
PPR) no significa que el comprobante ya esteautorizado; espera aAUT.
Otras tablas#
Tipo de emision y ambiente#
tipoEmision siempre es 1 (emision normal). Usa la URL de pruebas para
ensayar y la de produccion para emitir con validez fiscal; ve
Ambientes.
| Ambiente | Codigo SRI |
|---|---|
| Pruebas | 1 |
| Produccion | 2 |
Unidades de tiempo#
pagos[].unidadTiempo es obligatoria cuando plazo > 0. Valores habituales:
dias, meses, anios.
Monedas#
info.moneda usa el codigo de la moneda (por ejemplo DOLAR).
Paises (comercio exterior)#
paisOrigen, paisDestino, paisAdquisicion y codPaisPagoProveedorReembolso usan el codigo numerico de tres digitos del catalogo de paises del SRI. Ecuador es 593.
Fuente: SRI, catalogo de paises.
| Codigo | Descripcion |
|---|---|
| 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 |
Unidad de medida#
detalles[].unidadMedida es un texto libre de hasta 50 caracteres (el SRI no publica un catalogo cerrado para este campo). Valores habituales: Kilos, Litros, Unidades, Cajas.