Ejemplos por país
🔠 Tabla de códigos
Los siguientes son los códigos que se utilizarán en las operaciones peruanas. Use la navegación a la derecha para moverse rápidamente a diferentes IDs.
Todas las solicitudes a la API deben realizarse usando el ID de la primera columna. Los códigos externos son solo para fines de referencia.
country_id
| country_id |
name |
| 83 |
PERÚ |
| 1 |
SENEGAL |
| 2 |
GAMBIA |
| 3 |
GUINEA-BISSAU |
| 4 |
GUINEA |
| 5 |
SIERRA LEONA |
| 6 |
LIBERIA |
| 7 |
COSTA DE MARFIL |
| 8 |
GHANA |
| 9 |
TOGO |
| 10 |
NIGERIA |
| 11 |
SUDAFRICA |
| 12 |
BOTSWANA |
| 13 |
LESOTHO |
| 14 |
MALAWI |
| 15 |
ZIMBABWE |
| 16 |
ZAMBIA |
| 17 |
COMORAS |
| 18 |
MAURICIO |
| 19 |
MADAGASCAR |
| 20 |
MOZAMBIQUE |
| 21 |
SWAZILANDIA |
| 22 |
SUDAN |
| 23 |
EGIPTO |
| 24 |
LIBIA |
| 25 |
TUNEZ |
| 26 |
ARGELIA |
| 27 |
MARRUECOS |
| 28 |
CABO VERDE |
| 29 |
CHAD |
| 30 |
NIGER |
| 31 |
ALTO VOLTA |
| 32 |
MALI |
| 33 |
MAURITANIA |
| 34 |
TANZANIA |
| 35 |
UGANDA |
| 36 |
KENIA |
| 37 |
SOMALIA |
| 38 |
ETIOPIA |
| 39 |
ANGOLA |
| 40 |
BURUNDI |
| 41 |
RWANDA |
| 42 |
REP.DEM. CONGO |
| 43 |
CONGO |
| 44 |
GABON |
| 45 |
S.TOM.PRINCIPE |
| 46 |
GUINEA ECUATRL |
| 47 |
REP.CENT.AFRIC. |
| 48 |
CAMERUN |
| 49 |
BENIN |
| 50 |
TERR.BRIT.EN AF |
| 51 |
TER.ESPAN.EN AF |
| 52 |
TERR.FRAN.EN AF |
| 53 |
BOPHUTHATSWANA |
| 54 |
DJIBOUTI |
| 55 |
SEYCHELLES |
| 56 |
VIENDA |
| 57 |
NAMIBIA |
| 58 |
SUDAN DEL SUR |
| 59 |
BURKINA FASO |
| 60 |
CISKEY |
| 61 |
ERITREA |
| 62 |
ISLAS MARSHALL |
| 63 |
SAHARAUI |
| 64 |
TRANSKEI |
| 65 |
VENEZUELA |
| 66 |
COLOMBIA |
| 67 |
TRINID.Y TOBAGO |
| 68 |
BARBADOS |
| 69 |
JAMAICA |
| 70 |
REP.DOMINICANA |
| 71 |
BAHAMAS |
| 72 |
HAITI |
| 73 |
CUBA |
| 74 |
PANAMA |
| 75 |
COSTA RICA |
| 76 |
NICARAGUA |
| 77 |
EL SALVADOR |
| 78 |
HONDURAS |
| 79 |
GUATEMALA |
| 80 |
MEXICO |
| 81 |
GUYANA |
| 82 |
ECUADOR |
| 84 |
BRASIL |
| 85 |
BOLIVIA |
| 86 |
PARAGUAY |
| 87 |
URUGUAY |
| 88 |
ARGENTINA |
| 89 |
U.S.A. |
| 90 |
CANADA |
| 91 |
TERR.BRIT.EN AM |
| 92 |
TERR.FRAN.EN AM |
| 93 |
TER.HOLAN.EN AM |
| 94 |
TERR.D/DINAMARC |
| 95 |
DOMINICA |
| 96 |
GRANADA |
| 97 |
SANTA LUCIA(ISL |
| 98 |
S.VTE.Y GRANAD. |
| 99 |
SURINAM |
| 100 |
BELICE |
| 101 |
ANTIGUA Y BBUDA |
| 102 |
SNT.KIT & NEVIS |
| 103 |
ANGUILA |
| 104 |
ARUBA |
| 105 |
BERMUDAS |
| 106 |
ISLAS VIRG.BRIT |
| 107 |
ISLAS CAYMAN |
| 108 |
ANTILLAS NEERLANDESA |
| 109 |
TURCAS Y CAICOS |
| 110 |
ISLAS VIRGENES (ESTADOS UNIDOS DE AMERICA) |
| 111 |
MARTINICA |
| 112 |
PUERTO RICO |
| 113 |
MONSERRAT |
| 114 |
GROENLANDIA |
| 115 |
JORDANIA |
| 116 |
ARABIA SAUDITA |
| 117 |
KUWAIT |
| 118 |
OMAN |
| 119 |
CHIPRE |
| 120 |
ISRAEL |
| 121 |
IRAK |
| 122 |
AFGANISTAN |
| 123 |
IRAN |
| 124 |
SIRIA |
| 125 |
LIBANO |
| 126 |
QATAR |
| 127 |
BAHREIN |
| 128 |
SRI LANKA |
| 129 |
CAMBODIA |
| 130 |
LAOS |
| 131 |
INDIA |
| 132 |
BHUTAN |
| 133 |
THAILANDIA |
| 134 |
NEPAL |
| 135 |
BANGLADESH |
| 136 |
YEMEN |
| 137 |
YEMEN DEL SUR |
| 138 |
PAKISTAN |
| 139 |
VIETNAM |
| 140 |
MYANMAR (EX BIRMANIA) |
| 141 |
ISLAS MALDIVAS |
| 142 |
INDONESIA |
| 143 |
MALASIA |
| 144 |
TAIWAN (FORMOSA) |
| 145 |
JAPON |
| 146 |
SINGAPUR |
| 147 |
COREA DEL SUR |
| 148 |
COREA DEL NORTE |
| 149 |
FILIPINAS |
| 150 |
CHINA |
| 151 |
MONGOLIA |
| 152 |
EMIR.ARAB.UNID. |
| 153 |
HONG KONG |
| 154 |
TER.PORTUG.E/AS |
| 155 |
BRUNEI |
| 156 |
MACAO |
| 157 |
REPUBLICA DE YEMEN |
| 158 |
FIJI |
| 159 |
NAURU |
| 160 |
ISLAS TONGA |
| 161 |
SAMOA OCC. |
| 162 |
NUEVA ZELANDIA |
| 163 |
AUSTRALIA |
| 164 |
TERR.BRIT.EN AU |
| 165 |
TERR.FRAN.EN AU |
| 166 |
T.NORTEAM.EN AU |
| 167 |
PPUA.NVA.GUINEA |
| 168 |
VANUATU |
| 169 |
KIRIBATI |
| 170 |
MICRONESIA |
| 171 |
ISLAS SALOMON |
| 172 |
TUVALU |
| 173 |
PALAU |
| 174 |
NIUE |
| 175 |
POLINESIA FRANCESA |
| 176 |
NUEVA CALEDONIA |
| 177 |
ISLAS MARIANAS DEL NORTE |
| 178 |
GUAM |
| 179 |
TIMOR ORIENTAL |
| 180 |
ISLAS COOK |
| 181 |
PORTUGAL |
| 184 |
ITALIA |
| 185 |
FRANCIA |
| 186 |
IRLANDA |
| 187 |
DINAMARCA |
| 188 |
SUIZA |
| 189 |
AUSTRIA |
| 190 |
REINO UNIDO |
| 191 |
SUECIA |
| 192 |
FINLANDIA |
| 193 |
NORUEGA |
| 194 |
BELGICA |
| 195 |
HOLANDA |
| 196 |
ISLANDIA |
| 197 |
ESPAÑA |
| 198 |
ALBANIA |
| 199 |
RUMANIA |
| 200 |
GRECIA |
| 202 |
TURQUIA |
| 203 |
MALTA |
| 204 |
SANTA SEDE |
| 205 |
ANDORRA |
| 207 |
BULGARIA |
| 208 |
POLONIA |
| 209 |
CHECOESLOVAQUIA |
| 210 |
HUNGRIA |
| 211 |
LUXEMBURGO |
| 212 |
LIECHTENSTEIN |
| 213 |
MONACO |
| 214 |
SAN MARINO |
| 215 |
ARMENIA |
| 216 |
AZERBAIJAN |
| 217 |
BELARUS |
| 218 |
BOSNIA HEZGVINA |
| 219 |
REPUBLICA CHECA |
| 220 |
REP.ESLOVACA |
| 221 |
REPUBLICA DE SERBIA |
| 222 |
CROACIA |
| 223 |
ESLOVENIA |
| 224 |
ESTONIA |
| 225 |
GEORGIA |
| 226 |
KAZAJISTÁN |
| 227 |
KIRGISTÁN |
| 228 |
LETONIA |
| 229 |
LITUANIA |
| 230 |
MACEDONIA |
| 231 |
MOLDOVA |
| 232 |
TAYIKISTÁN |
| 233 |
TURKMENISTÁN |
| 234 |
UCRANIA |
| 235 |
UZBEKISTÁN |
| 236 |
MONTENEGRO |
| 237 |
RUSIA |
| 238 |
ALEMANIA |
| 240 |
GIBRALTAR |
| 241 |
GUERNSEY |
| 242 |
ISLA DE MAN |
| 243 |
JERSEY |
| 244 |
GILBRALTAR |
| 245 |
COMB.Y LUBRIC. |
| 246 |
RANCHO DE NAVES |
| 247 |
PESCA EXTRA |
| 248 |
ORIG.O DEST. NO |
| 249 |
ZF.IQUIQUE |
| 250 |
DEPOSITO FRANCO |
| 251 |
ZF.PARENAS |
| 252 |
ZF.ARICA-ZF IND |
| 253 |
CHILE |
| 254 |
NAC.REPUTADA |
| 255 |
OTROS(PAIS DESCONOCIDO) |
currency_id
| currency_id |
name |
external_code |
| 7 |
Sol |
PEN |
| 5 |
Dolar USA |
USD |
| 38 |
Euro |
EUR |
tax_id_type
| tax_id_type |
name |
regular_expression |
additional_validations |
| PE-RUC |
Número de Identificación del Contribuyente Peruano (RUC) |
^\d{11}$ |
Formato: 11 dígitos numéricos. Estructura: los primeros dígitos indican el tipo de contribuyente (10 = persona natural, 20/17/15 = persona jurídica). Incluye un dígito verificador calculado mediante el algoritmo Mod 11. |
| PE-DNI |
Documento Nacional de Identidad (DNI) |
^\d{8}$ |
8 dígitos numéricos. Sin dígito verificador. |
| PE-CE |
Carné de Extranjería (CE) |
^[A-Za-z0-9]{9,12}$ |
Identificador alfanumérico emitido a residentes extranjeros. Longitud entre 9 y 12 caracteres. Sin dígito verificador. Se permiten letras y números. |
| PE-PAS |
Pasaporte |
^[A-Za-z0-9]{6,12}$ |
Identificador alfanumérico emitido por el país del titular del pasaporte. Longitud típica de 6 a 12 caracteres. Sin validación algorítmica debido a la variación internacional. |
| PE-XXX |
No domiciliado / Sin ID peruano |
^.{1,20}$ |
Utilizado cuando el receptor no tiene un ID peruano estándar (ej., turistas). Se acepta cualquier identificador de hasta 20 caracteres. Sin reglas de validación reguladas. |
document_type_id
| document_type_id |
Nombre |
received_issued_flag |
Código Externo |
| 96 |
Factura emitida |
1 |
01 |
| 97 |
Boleta de venta emitida |
1 |
03 |
| 98 |
Nota de crédito para Factura emitida |
1 |
07 |
| 99 |
Nota de débito emitida |
1 |
08 |
| 100 |
Guia de remisión para remitente emitida |
1 |
09 |
| 101 |
Guia de remisión para Transportista emitida |
1 |
31 |
| 102 |
Factura recibida |
0 |
01 |
| 103 |
Boleta de venta recibida |
0 |
03 |
| 104 |
Nota de crédito recibida |
0 |
07 |
| 105 |
Nota de débito recibida |
0 |
08 |
| 107 |
Guia de remisión para remitente recibida |
0 |
09 |
| 108 |
Guia de remisión para Transportista recibida |
0 |
31 |
| 109 |
Comprobante de retención emitido |
1 |
20 |
| 110 |
Comprobante de retención recibido |
1 |
20 |
| 155 |
Nota de crédito para Boleta emitida |
1 |
07 |
tax_type_id
| tax_type_id |
name |
tax_type |
value |
external_code |
| 412 |
IGV 16% |
2 |
16,0000 |
1000 |
| 413 |
IGV 18% |
2 |
18,0000 |
1000 |
| 414 |
IGV 0% |
2 |
0,0000 |
9997 |
| 415 |
ISC Alcohol 20% |
2 |
20,0000 |
2000 |
| 416 |
ISC Alcohol 50% |
2 |
50,0000 |
2000 |
| 417 |
ISC Bebidas azucaradas 17% |
2 |
17,0000 |
2000 |
| 418 |
ISC Cigarrillos |
3 |
0,0000 |
2000 |
| 419 |
ISC Combustibles |
3 |
0,0000 |
2000 |
| 420 |
ISC Vehículos 10% |
2 |
10,0000 |
2000 |
| 421 |
ISC Vehículos 20% |
2 |
20,0000 |
2000 |
| 422 |
ISC Vehículos Otros |
3 |
0,0000 |
2000 |
| 423 |
ISC Bebidas azucaradas 25% |
2 |
25,0000 |
2000 |
| 424 |
ISC Alcohol |
3 |
0,0000 |
2000 |
| 425 |
Exportación |
2 |
0,0000 |
9995 |
| 426 |
Operaciones gratuitas |
2 |
0,0000 |
9996 |
| 427 |
Operaciones exoneradas |
2 |
0,0000 |
9997 |
| 428 |
Operaciones inafectas |
2 |
0,0000 |
9998 |
| 429 |
Otros conceptos de pago |
3 |
0,0000 |
9999 |
Notas:
Valores de tax_type:
1 = valor fijo en dinero
2 = porcentaje fijo
3 = valor variable en dinero a definir por el usuario como parte de la solicitud
tax_value:
Los números positivos se suman al monto final, mientras que los valores negativos son retenciones y disminuirán el monto final
operation_type
Los tipos de operación se usan en el campo additional >> pe_header
| operation_type |
Nombre |
Descripción |
| 0101 |
Venta interna |
Venta de bienes o servicios dentro del territorio nacional. |
| 0200 |
Exportación de bienes |
Operaciones de exportación exentas del Impuesto al Valor Agregado (IVA). |
| 0301 |
Pagos anticipados |
Pagos anticipados por bienes o servicios que serán entregados o prestados en el futuro. |
| 0401 |
Operaciones por intermediarios |
Ventas en consignación u otras operaciones realizadas a través de intermediarios. |
| 1001 |
Operación sujeta a Detracción |
Transacciones donde se aplica el sistema de detracciones para garantizar el cumplimiento tributario. |
| 2001 |
Operación sujeta a Percepción |
Ventas sujetas al sistema de percepción del IGV, donde el comprador adelanta una parte del impuesto. |
| 3001 |
Operación sujeta a Retención |
Operaciones donde el comprador actúa como agente de retención del IGV. |
| 4001 |
Operación exenta de IGV |
Ventas de bienes o servicios exentos del IGV según la normativa. |
| 5001 |
Operación con IGV e ISC |
Transacciones donde se aplican tanto el IGV (Impuesto al Valor Agregado) como el ISC (Impuesto Selectivo al Consumo). |
| 9999 |
Otros |
Operaciones atípicas o específicas no clasificadas dentro de las categorías estándar. |
unit_measure
| unit_measure |
name |
| CAJA |
Caja |
| CM |
Centimetros |
| CM2 |
Centimetros cuadrados |
| GR |
Gramo |
| KG |
Kilogramos |
| KWH |
Kilowatt Hora |
| LT |
Litro |
| LTS |
Litros |
| MTS |
Metros |
| MT2 |
Metros cuadrados |
| MT3 |
Metros cúbicos |
| PAR |
Par |
| PACK |
Pack |
| PLG |
Pulgadas |
| TON |
Toneladas |
| UF |
Unidad de fomento |
| UN |
Unidad |
| BOX |
Box |
| PLT |
Pallets |
| CONT |
Contenedor |
| PCS |
Piezas |
| PART |
Partes |
| TRAY |
Bandejas |
| SET |
Set |
| RM |
Resma |
| PLIE |
Pliego |
| HRS |
Horas |
Estado de certificación de la cuenta (certification_status)
| certification_status |
name |
customer_action_required |
explanation |
| 0 |
Cuenta creada |
Sí |
La cuenta fue creada, pero no se ha cargado ningún certificado. |
| 21 |
Situación tributaria |
Sí |
La SUNAT no permite continuar el proceso. Verifique los detalles del estado y tome acción. |
| 22 |
Inactiva |
Sí |
Existe un problema en el proceso de certificación que el cliente no ha resuelto. |
| 23 |
Programada para eliminación |
Sí |
Esta cuenta está programada para ser eliminada. |
| 70 |
Lista para ser activada |
No |
La información fue recibida exitosamente y estamos listos para activar las facturas. |
| 71 |
En espera: Declaración pausada por el cliente |
Sí |
El proceso de declaración está pausado debido a una solicitud o acción del cliente. |
| 72 |
En espera: Declaración pausada por problema tributario |
Sí |
El proceso de declaración está pausado debido a un problema tributario identificado por la SUNAT. Verifique los detalles y tome acción. |
| 80 |
Certificación de factura |
No |
La cuenta está certificada para emitir facturas. |
special_instructions
| code |
field_name |
explanation |
| 1 |
SUNAT_Envio_IndicadorTrasladoTotalDAMoDS |
Indica que el traslado está amparado por una Declaración Aduanera de Mercancías (DAM) o Declaración Simplificada (DS). Requerido cuando el motivo del envío es importación/exportación y debe incluir el documento aduanero correspondiente. |
| 2 |
SUNAT_Envio_IndicadorTransbordoProgramado |
Indica que los bienes forman parte de un trasbordo programado. Se usa cuando la carga será transferida de una unidad de transporte a otra como parte de una ruta logística planificada. |
| 3 |
SUNAT_Envio_IndicadorTrasladoVehiculoM1L |
Indica que el transporte de los bienes se realizará usando un vehículo de categoría M1 o L (vehículo ligero o motocicleta). La SUNAT lo requiere cuando el envío se realiza con un vehículo pequeño/ligero. |
| 4 |
SUNAT_Envio_IndicadorRetornoVehiculoEnvaseVacio |
Indica el retorno de un vehículo que transporta envases o embalajes vacíos. Se usa cuando se entregan envases y el vehículo regresa con unidades vacías. |
| 5 |
SUNAT_Envio_IndicadorRetornoVehiculoVacio |
Indica que la unidad de transporte regresa completamente vacía, sin mercancías ni envases. Se usa cuando solo regresa el vehículo. |
| 6 |
SUNAT_Envio_IndicadorVehiculoConductoresTransp |
Indica que el transporte incluye múltiples conductores o que el personal de transporte forma parte del registro del envío. Se usa para operaciones logísticas especiales que incluyen más de un conductor. |
handling_code
| reason_id |
name |
description |
| 01 |
Venta |
Indica que el traslado se debe a una venta. |
| 02 |
Compra |
Indica que el traslado se debe a una compra. |
| 13 |
Otro |
Indica que el traslado se debe a otras razones no clasificadas anteriormente. |
template_id
| template_id |
document_type_id |
format |
name |
| 5000 |
96 |
80mm (Thermal) |
Invoice (Factura electrónica). |
| 5001 |
97 |
80mm (Thermal) |
Receipt (Boleta electrónica). |
| 5002 |
100 |
80mm (Thermal) |
Shipping Guide for Shipper (Guia de remisión para remitente). |