ES | EN

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.
0112 Venta interna – Sustenta gastos deducibles persona natural Venta interna que sustenta gastos deducibles de una persona natural.
0200 Exportación de bienes Operaciones de exportación de bienes.
0201 Exportación de servicios – Prestación de servicios realizados íntegramente en el país Servicios prestados íntegramente en Perú a un no domiciliado.
0202 Exportación de servicios – Servicios de hospedaje no domiciliado Servicios de hospedaje prestados a no domiciliados.
0203 Exportación de servicios – Transporte de navieras Servicios de transporte prestados por navieras.
0204 Exportación de servicios – Servicios a naves y aeronaves de bandera extranjera Servicios prestados a naves y aeronaves de bandera extranjera.
0205 Exportación de servicios – Servicios que conformen un paquete turístico Servicios que forman parte de un paquete turístico.
0206 Exportación de servicios – Servicios complementarios al transporte de carga Servicios complementarios al transporte internacional de carga.
0207 Exportación de servicios – Suministro de energía eléctrica a favor de sujetos domiciliados en ZED Suministro de energía eléctrica a sujetos domiciliados en una Zona Especial de Desarrollo.
0208 Exportación de servicios – Prestación de servicios realizados parcialmente en el extranjero Servicios prestados en parte en el extranjero.
0301 Operaciones con carta de porte aéreo Operaciones con carta de porte aéreo emitidas en el ámbito nacional.
0302 Operaciones de transporte ferroviario de pasajeros Servicios de transporte ferroviario de pasajeros.
0303 Operaciones de pago de regalía petrolera Pago de regalía petrolera.
0401 Ventas no domiciliados que no califican como exportación Ventas a no domiciliados que no califican como exportación.
1001 Operación sujeta a detracción Detracción general. Incluya el bloque pe_detraction con cualquier código del catálogo 54 (ejemplo: código 022 al 12%).
1002 Detracción — Recursos hidrobiológicos Operación sujeta a detracción por recursos hidrobiológicos. Incluya pe_detraction (código 004: 4% si el proveedor cumple las condiciones de SUNAT; si no, 10%).
1003 Detracción — Transporte de pasajeros Operación sujeta a detracción por transporte de pasajeros. Incluya pe_detraction (código 028; SUNAT fija un monto por eje del vehículo, no un porcentaje).
1004 Detracción — Transporte de carga Operación sujeta a detracción por transporte de carga. Incluya pe_detraction (código 027, 4% sobre el mayor entre el importe de la operación y el valor referencial) 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.

pe_detraction

Campos del bloque header >> additional >> pe_detraction. Es obligatorio cuando pe_header.operation_type es 1001, 1002, 1003 o 1004; si falta, la API responde: When operation_type is 1001, 1002, 1003 or 1004, header.additional.pe_detraction is required.

campo tipo obligatorio descripción
code string Sí Código del catálogo 54 (ver detraction_code). Con 1002, 1003 y 1004 debe ser 004, 028 y 027 respectivamente; si no, la API responde pe_detraction.code must be XXX when operation_type is YYYY.
percent number Sí Porcentaje de detracción, mayor que 0.
amount number Sí Monto de la detracción, mayor que 0 (normalmente percent aplicado sobre total_amount; en 1004, sobre el mayor entre el importe de la operación y el valor referencial del transporte).
nation_bank_account string Sí Cuenta de detracciones del Banco de la Nación. Si falta, la API responde pe_detraction.nation_bank_account is required.
nation_bank_account_hide boolean No Solo acepta true: oculta la cuenta en el PDF (se sigue enviando en el XML). Con otro valor la API responde pe_detraction.nation_bank_account_hide only accepts true.
payment_means_code string No Medio de pago (catálogo 59). Por defecto 001.

detraction_code

Los códigos de detracción se usan en additional >> pe_detraction >> code (catálogo 54 de SUNAT). Con 1002, 1003 y 1004 el código es fijo; 1001 acepta cualquier código del catálogo 54 (la API solo valida el código en 1002, 1003 y 1004). El campo amount suele ser el percent aplicado sobre total_amount.

Las tasas las fija SUNAT y pueden cambiar; verifique la vigente en sunat.gob.pe.

code Nombre percent operation_type
001 Azúcar y melaza de caña 10 1001
003 Alcohol etílico 10 1001
004 Recursos hidrobiológicos 4 o 10 1002
005 Maíz amarillo duro 4 1001
007 Caña de azúcar 10 1001
008 Madera 4 1001
009 Arena y piedra 10 1001
010 Residuos, subproductos, desechos, recortes y desperdicios 15 1001
012 Intermediación laboral y tercerización 12 1001
014 Carnes y despojos comestibles 4 1001
016 Aceite de pescado 10 1001
017 Harina, polvo y pellets de pescado, crustáceos, moluscos y demás invertebrados acuáticos 4 1001
019 Arrendamiento de bienes muebles 10 1001
020 Mantenimiento y reparación de bienes muebles 12 1001
021 Movimiento de carga 10 1001
022 Otros servicios empresariales 12 1001
023 Leche 4 1001
024 Comisión mercantil 10 1001
025 Fabricación de bienes por encargo 10 1001
026 Servicio de transporte de personas 10 1001
027 Servicio de transporte de carga 4 1004
028 Transporte de pasajeros Monto por eje 1003
030 Contratos de construcción 4 1001
031 Oro gravado con el IGV 10 1001
032 Páprika y otros frutos de los géneros capsicum o pimienta 10 1001
034 Minerales metálicos no auríferos 10 1001
035 Bienes exonerados del IGV 1.5 1001
036 Oro y demás minerales metálicos exonerados del IGV 1.5 1001
037 Demás servicios gravados con el IGV 12 1001
039 Minerales no metálicos 10 1001
041 Plomo 15 1001
  • 004: 4% solo si el proveedor es titular del permiso de pesca de la embarcación y figura en el listado de proveedores al 4% que publica SUNAT; en otro caso, 10%.
  • 027: 4% sobre el mayor entre el importe de la operación y el valor referencial del transporte (D.S. N° 020-2021-MTC), salvo que no exista valor referencial o la carga sea de dos o más usuarios.
  • 028: SUNAT fija un monto por eje del vehículo en cada peaje (R.S. N° 057-2007/SUNAT), no un porcentaje. La API igual exige percent y amount mayores que 0.

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

El campo details >> unit_measure se envía tal cual a SUNAT como unitCode (UN/ECE rec 20, catálogo 03); la API no lo traduce. Un código fuera del catálogo puede ser rechazado por SUNAT. Recomendamos ZZ para servicios y NIU para bienes.

unit_measure name
NIU Unidad (bienes)
ZZ Unidad (servicios)
KGM Kilogramo
GRM Gramo
TNE Tonelada
LTR Litro
MLT Mililitro
GLL Galón
MTR Metro
CMT Centímetro
MTK Metro cuadrado
CMK Centímetro cuadrado
MTQ Metro cúbico
INH Pulgada
BX Caja
PK Paquete
PF Paleta
PR Par
SET Juego
DZN Docena
BG Bolsa
RM Resma
ST Pliego
BO Botella
CA Lata
HUR Hora
DAY Día
MON Mes
KWH Kilovatio hora

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