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 |
La serie de la guía de remisión remitente (100) suele comenzar con T. La serie de la guía de remisión transportista (101) debe comenzar con V.
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 | Detracción general. Incluya el bloque pe_detraction (ejemplo: código 022 al 9%). |
| 1003 | Detracción — Transporte de pasajeros | Operación sujeta a detracción por transporte de pasajeros. Incluya pe_detraction (código 028, 10%). |
| 1004 | Detracción — Transporte de carga | Operación sujeta a detracción por transporte de carga. Incluya pe_detraction (código 027, 12%) y pe_cargo_transport. Si falta pe_cargo_transport, E-Fact responde 3116. |
| 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. |
detraction_code
Los códigos de detracción se usan en additional >> pe_detraction >> code y deben coincidir con el operation_type de pe_header. El campo amount suele ser el percent aplicado sobre total_amount.
| code | operation_type | Nombre | percent (ejemplo) |
|------|----------------|--------------------------------|-------------------|
| 022 | 1001 | Detracción general | 9.00 |
| 028 | 1003 | Transporte de pasajeros | 10.00 |
| 027 | 1004 | Transporte de carga | 12.00 |
En 1004 también es obligatorio pe_cargo_transport (ubigeo y dirección de origen y destino, detalle del viaje y montos de referencia). Si se omite, E-Fact responde 3116.
payment_means_code (detracción)
Se usa en additional >> pe_detraction >> payment_means_code.
| payment_means_code | Nombre |
|--------------------|---------------------------------------------|
| 001 | Depósito en cuenta (Banco de la Nación) |
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
Plantillas de PDF del sistema disponibles para options.template_id. Si no envía template_id, se usa la plantilla predeterminada del tipo de documento. La plantilla debe corresponder al document_type_id del documento.
| template_id | document_type_id | Nombre |
|-------------|------------------|--------|
| 5000 | 96 | Factura emitida |
| 5004 | 96 | Factura hoja carta modelo 3 |
| 5001 | 97 | Boleta de venta |
| 5005 | 97 | Boleta hoja carta modelo 3 |
| 5006 | 98 | Nota de crédito Factura carta modelo 3 |
| 5008 | 99 | Nota de débito carta modelo 3 |
| 5002 | 100 | Guia de remisión para remitente emitida |
| 5009 | 100 | Guia de remisión remitente electrónica carta modelo 3 |
| 5010 | 101 | Guia de remisión transportista 80mm |
| 5011 | 101 | Guia de remisión transportista electrónica carta modelo 3 |
| 5007 | 155 | Nota de crédito Boleta carta modelo 3 |