Detalles de Trama

En esta sección encontrarás el diccionario de datos detallado de todos los campos necesarios para enviar la trama de facturación (Request), así como los campos que devuelve el sistema tras su procesamiento (Response).

Detalle Trama Request

ENDPOINT: /api/v1/generarDEXMLV21

Cabecera de la Trama

Campo	Descripción / Valor	Formato
tipo_oper	Tipo de operación de Sunat. Referencia: Catalogo N° 01	-
docu_tipodocumento	Tipo de comprobante de pago. Referencia : Catálogo N° 02	-
docu_fecha_emision	Fecha de emisión del documento.	yyyy-mm-dd (ejemplo 2018-05-01)
docu_hora_emision	Hora de emisión del documento.	HH:MM:SS
docu_serie	Serie del Documento	-
docu_numero	Nro. del Documento.	-
docu_fecha_venc	Fecha de vencimiento del documento.	yyyy-mm-dd (ejemplo 2018-05-01)
docu_moneda	Moneda del documento. Referencia: Catalogo N° 03	-
docu_tipo_cambio	Tipo de cambio respecto a la moneda.	######.## (2 decimales)
docu_porc_igv	Porcentaje del IGV.	###.## (2 decimales)
docu_porc_isc	Porcentaje del ISC.	###.## (2 decimales)
docu_dscto_global	Monto Total de los descuentos Globales.	###.## (2 decimales)
docu_total_dscto	Corresponde a la sumatoria de los descuentos de línea (ítem) + descuentos globales.	###.## (2 decimales)
docu_total_anticipo	Valor de total de la Regulación de Anticipo(s).	###.## (2 decimales)
docu_total_gravada	Total valor de venta - operaciones gravadas.	###.## (2 decimales)
docu_total_inafecta	Total valor de venta - operaciones inafectas.	###.## (2 decimales)
docu_total_exonerada	Total valor de venta - operaciones exoneradas	###.## (2 decimales)
docu_total_igv	Corresponde al IGV Total de la factura.	###.## (2 decimales)
docu_total_gratuita	Total Valor de Venta de Operaciones gratuitas.	###.## (2 decimales)
docu_total_otros_cargos	Corresponde al total de otros cargos cobrados al adquirente o usuario.	###.## (2 decimales)
docu_total_otros_atrib	Corresponde al total de los otros tributos.	###.## (2 decimales)
docu_total	Corresponde al importe total de la venta, de la cesión en uso o del servicio prestado.	###.## (2 decimales)
docu_isc	Corresponde al ISC Total de la factura.	###.## (2 decimales)
docu_tipo_percep		2001
docu_base_imp_percep	Base imponible percepción.	###.## (2 decimales)
docu_total_percepcion	Monto de la percepción.	###.## (2 decimales)
docu_total_incl_percepcion	Monto Total Incluida la percepción.	###.## (2 decimales)
docu_mot_dcto	Codigo de Descsuento. Referencia: Catálogo N°04	-
docu_detraccion	Flag para indicar si se trata de una detracción.	boolean (true, false)
docu_observaciones	Motivo o Sustento. Observaciones del documento.	-
docu_tipo_docu_modif	Tipo de documento del documento que modifica. Referencia : Catálogo N° 02	-
docu_serie_docu_modif	Serie del documento que modifica.	-
docu_nro_docu_modif	Número del documento que modifica.	-
docu_tipo_nota_credito	Código de tipo de nota de crédito. Referencia: Catalogo N° 05	-
docu_tipo_nota_debito	Código de tipo de nota de débito. Referencia: Catalogo N° 06	-
enviarCorreoCliente	Flag para enviar el correo al cliente con los archivos del CPE. Referencia: Catalogo N° 07	-
ambSunat	Flag para indicar a que ambiente de Sunat se enviará la trama. Referencia: Catálogo N° 08	-
clie_numero	Número de documento de identidad del adquirente o usuario.	-
clie_tipodoc	Tipo de documento de identidad del adquirente o usuario. Referencia Catálogo No. 09	-
clie_nombre	Apellidos y nombres, denominación o razón social del adquirente o usuario.	-
clie_direccion	Dirección del Cliente	-
clie_correo_cpe0	Correo N1 del Cliente al que se le informará	-
empr_razonsocial	Apellidos y nombres o denominación o razón social.	-
empr_ubigeo	Código de Ubigeo de la Empresa. Utilizar el catálogo de ubigeos del INEI	-
empr_nombrecomercial	Nombre Comercial.	-
empr_direccion	Dirección Detallada.	-
empr_provincia	Provincia de la Empresa.	-
empr_departamento	Departamento de la Empresa.	-
empr_distrito	Distrito de la Empresa.	-
empr_pais	País de la Empresa	-
empr_nroruc	Número de RUC del emisor.	-
empr_tipodoc	Tipo de Documento del Emisor. Referencia Catálogo No. 09	-
empr_codEstb	Codigo de Establecimiento	-
formaPago	Forma de Pago. Referencia: Catalogo N° 10	-
lista_docRelacionado	Arreglo de documentos relacionados al CPE	Array
lista_docRelacionado.docu_tipo	Tipo de documento relacionado. Referencia: Catalogo N° 11	-
lista_docRelacionado.docu_serie_numero	Serie y nro del Documento relacionado	FF01-45
lista_docRelacionado.rucEmisor	Serie del Emisor Ruc	20550629357

Items de la Trama (Arreglo)

Campo	Descripción / Valor	Formato
item_unidad_medida	Unidad de medida por ítem.	-
item_codigo	Código del producto de acuerdo al tipo de codificación interna de su sistema que se utilice.	-
item_descr	Descripción detallada del servicio prestado, bien vendido o cedido en uso, indicando las características.	-
item_cantidad	Cantidad de unidades por ítem.	-
item_valor_unitario	Precio de venta unitario por ítem y código.	-
item_precio_unitario	Valor unitario por ítem.	-
item_descuento	Monto del descuento por Item.	-
item_pnohonerosa	Valor referencial unitario en operaciones no onerosas.	-
item_subTotal	Moneda e Importe monetario que es el total de la línea de detalle, incluyendo variaciones de precio (subvenciones, cargos o descuentos) pero sin impuestos.	-
item_tipo_igv	Códigos de Tipo de Afectación del IGV. Referencia: Catalogo N° 12	-
item_igv	Monto de IGV de la línea.	-
item_total	Monto Total del Ítem	-
item_antic_regula	Flag para indicar si el ítem regulariza un anticipo. Catalogo N°13	-
item_antic_docu_serie	Serie de comprobante del anticipo	-
item_antic_docu_nro	Nro de comprobante del anticipo	-
item_antic_monto	Monto total de anticipos del comprobante.	-
item_antic_tipodoc_emi	Tipo de Doc. del emisor del comprobante de anticipo.(06)	-
item_antic_nrodoc_emi	Número de RUC del emisor del comprobante de anticipo	-
item_tasa_igv	Porcentaje del IGV.	-
item_monto_isc	Monto de ISC de la línea.	-
item_tipo_isc	Tipo de sistema de ISC. Referencia: Catalogo N° 14	-

Detalle Trama Response

Trama de Respuesta

Campo	Descripción / Valor	Formato
tipocompr	Tipo de comprobante de pago. Referencia : Catálogo N° 02	-
serieCompr	Serie del Documento	-
nroCompr	Nro. del Documento.	-
urlCompr	Link de descarga del pdf generado	-
estadoSunat	Estado de procesamiento en SUNAT. Referencia : Catálogo N° 17	-
descrSunat	Mensaje de rpta del procesamiento en SUNAT	-
urlXML	Link de descarga del XML enviado a SUNAT	-
urlCDR	Link de descarga del XML de respuesta de SUNAT	-
codRpta	Codigo de Respuesta de Procesamiento. Referencia : Catálogo N° 17	-
msjRpta	Mensaje de Respuesta del Procesamiento	-