Diferencia entre revisiones de «Web Service REST - Método Enviar»

De Facturacion Electronica de Peru
Ir a la navegación Ir a la búsqueda
Línea 14: Línea 14:
! ''Código de retorno <nowiki>|</nowiki> Estatus <nowiki>|</nowiki> Hora <nowiki>|</nowiki> Mensaje <nowiki>|</nowiki> Serie y correlativo del documento  <nowiki>|</nowiki> XML timbrado''
! ''Código de retorno <nowiki>|</nowiki> Estatus <nowiki>|</nowiki> Hora <nowiki>|</nowiki> Mensaje <nowiki>|</nowiki> Serie y correlativo del documento  <nowiki>|</nowiki> XML timbrado''
|}
|}


==Leyenda==
==Leyenda==
Línea 1699: Línea 1700:
|<!---Obligatorio--->    style="text-align:center;"|  
|<!---Obligatorio--->    style="text-align:center;"|  
|<!---Opcional--->      style="text-align:center;"| F, B
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|}
<!----OPERACIONES TURISTICAS-------->
==Operaciones Turísticas==
<!----OPERACIONES TURISTICAS - INFORMACION DE HOSPEDAJE-------->
===Operaciones Turísticas - Información de Hospedaje===
{| style="text-align:left;"
!Ubicación en Objeto:
! style="color: blue" | Enviar/DocumentoElectronico/operacionesTuristicas/Hospedaje
|-
!Cantidad de Campos:
!style="text-align:left;"| 10
|-
!Descripción General:
!style="text-align:left;"| Contiene la información referente a las operaciones turísticas, específicamente relacionadas con hospedaje
|-
!Recurrencia de la línea:
! 0...n
|}
{| class="wikitable" style="margin: auto;"
!Campo                                    <!----Encabezado de Tabla---->
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Formato
!Obligatorio
!Opcional                                <!----Encabezado de Tabla FIN---->
|-
|<!---Campo--->          style="color: blue; text-align:center"| codigoPaisEmisionPasaporte
|<!---Descripción--->    Código de país de emisión del pasaporte
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>2
|<!---Formato--->        style="text-align:center"|  Catálogo N° 04
|<!---Obligatorio--->    style="text-align:center;"|           
|<!---Opcional--->      style="text-align:center;"|  F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| codigoPaisResidenciaHuesped
|<!---Descripción--->    Código de país de residencia del huésped
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>2
|<!---Formato--->        style="text-align:center"| Catálogo N° 04
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| diasPermanencia
|<!---Descripción--->    Días de permanencia en el establecimiento
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>...4
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| fechaConsumo
|<!---Descripción--->    Fecha de consumo del huésped
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>10
|<!---Formato--->        style="text-align:center"| YYYY-MM-DD
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| fechaIngresoHotel
|<!---Descripción--->    Fecha de ingreso del huésped al establecimiento
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>10
|<!---Formato--->        style="text-align:center"| YYYY-MM-DD
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| fechaIngresoPais
|<!---Descripción--->    Fecha de ingreso del huésped al país
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>10
|<!---Formato--->        style="text-align:center"| YYYY-MM-DD
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| fechaSalidaHotel
|<!---Descripción--->    Fecha de salida del huésped al establecimiento
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>10
|<!---Formato--->        style="text-align:center"| YYYY-MM-DD
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| numDocumentoHuesped
|<!---Descripción--->    Número de documento del huésped
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...30
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| razonSocialHuesped
|<!---Descripción--->    Apellidos y nombres, denominación o razón social del huésped
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...100
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| tipoDocumentoHuesped
|<!---Descripción--->    Tipo de documento del huésped
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...15
|<!---Formato--->        style="text-align:center"| Catálogo N° 06
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|}
<!----OPERACIONES TURISTICAS - INFORMACION DE PAQUETE TURÍSTICO-------->
===Operaciones Turísticas - Información de Paquete Turístico===
{| style="text-align:left;"
!Ubicación en Objeto:
! style="color: blue" | Enviar/DocumentoElectronico/operacionesTuristicas/paqueteTuristico
|-
!Cantidad de Campos:
!style="text-align:left;"| 4
|-
!Descripción General:
!style="text-align:left;"| Contiene la información referente a las operaciones turísticas, específicamente para paquetes turísticos
|-
!Recurrencia de la línea:
! 0...n
|}
{| class="wikitable" style="margin: auto;"
!Campo                                    <!----Encabezado de Tabla---->
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Formato
!Obligatorio
!Opcional                                <!----Encabezado de Tabla FIN---->
|-
|<!---Campo--->          style="color: blue; text-align:center"| codigoPaisEmisionPasaporte
|<!---Descripción--->    Código de país de emisión del pasaporte
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>2
|<!---Formato--->        style="text-align:center"|  Catálogo N° 04
|<!---Obligatorio--->    style="text-align:center;"|           
|<!---Opcional--->      style="text-align:center;"|  F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| numDocumentoHuesped
|<!---Descripción--->    Número de documento del huésped
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...30
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| razonSocialHuesped
|<!---Descripción--->    Apellidos y nombres, denominación o razón social del turista
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...100
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| tipoDocumentoHuesped
|<!---Descripción--->    Tipo de documento del huésped
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...15
|<!---Formato--->        style="text-align:center"| Catálogo N° 06
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|}
<!----OPERACIONES TURISTICAS - INFORMACION DE TRANSPORTE DE PASAJEROS-------->
===Operaciones Turísticas - Información de Transporte de Pasajeros===
{| style="text-align:left;"
!Ubicación en Objeto:
! style="color: blue" | Enviar/DocumentoElectronico/operacionesTuristicas/transportePasajeros
|-
!Cantidad de Campos:
!style="text-align:left;"| 10
|-
!Descripción General:
!style="text-align:left;"| Contiene la información referente a las operaciones turísticas, específicamente transporte de pasajeros
|-
!Recurrencia de la línea:
! 0...n
|}
{| class="wikitable" style="margin: auto;"
!Campo                                    <!----Encabezado de Tabla---->
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Formato
!Obligatorio
!Opcional                                <!----Encabezado de Tabla FIN---->
|-
|<!---Campo--->          style="color: blue; text-align:center"| direccionDestino
|<!---Descripción--->    Dirección detallada de destino
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...200
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|           
|<!---Opcional--->      style="text-align:center;"|  F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| direccionOrigen
|<!---Descripción--->    Dirección detallada de origen
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...200
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| fechaHoraInicioProgramado
|<!---Descripción--->    Fecha y hora de inicio programado
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>19
|<!---Formato--->        style="text-align:center"| YYYY-MM-DD hh:mm:ss
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| infoManifiestoPasajero
|<!---Descripción--->    Información de manifiesto de pasajero
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...100
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| numAsiento
|<!---Descripción--->    Número de asiento del pasajero
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...100
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| numIDPasajero
|<!---Descripción--->    Número de documento del huésped
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...30
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| razonSocialPasajero
|<!---Descripción--->    Nombres y apellidos del pasajero
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...100
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| tipoIDPasajero
|<!---Descripción--->    Tipo de documento del huésped
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...30
|<!---Formato--->        style="text-align:center"| Catálogo N° 06
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| ubigeoDestino
|<!---Descripción--->    Ciudad o lugar de destino (código UBIGEO)
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>6
|<!---Formato--->        style="text-align:center"| Catálogo N° 13
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| ubigeoOrigen
|<!---Descripción--->    Ciudad o lugar de origen (código UBIGEO)
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>6
|<!---Formato--->        style="text-align:center"| Catálogo N° 13
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|}
<!----PAGO-------->
==Pago==
{| style="text-align:left;"
!Ubicación en Objeto:
! style="color: blue" | Enviar/DocumentoElectronico/pago
|-
!Cantidad de Campos:
!style="text-align:left;"| 5
|-
!Descripción General:
!style="text-align:left;"| Contiene información del pago del documento
|-
!Recurrencia de la línea:
! 1
|}
{| class="wikitable" style="margin: auto;"
!Campo                                    <!----Encabezado de Tabla---->
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Formato
!Obligatorio
!Opcional                                <!----Encabezado de Tabla FIN---->
|-
|<!---Campo--->          style="color: blue; text-align:center"| fechaFin
|<!---Descripción--->    Fecha de fin de ciclo de facturación
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>10
|<!---Formato--->        style="text-align:center"|  YYYY-MM-DD
|<!---Obligatorio--->    style="text-align:center;"|           
|<!---Opcional--->      style="text-align:center;"|  F, B, NC, ND
|-
|<!---Campo--->          style="color: blue; text-align:center"| fechaInicio
|<!---Descripción--->    Fecha de inicio de ciclo de facturación
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>10
|<!---Formato--->        style="text-align:center"|  YYYY-MM-DD
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B, NC, ND 
|-
|<!---Campo--->          style="color: blue; text-align:center"| metodoPago
|<!---Descripción--->    Medio de pago utilizado en el documento
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>3
|<!---Formato--->        style="text-align:center"| Catálogo N° 59
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"|  F, B, NC, ND
|-
|<!---Campo--->          style="color: blue; text-align:center"| moneda
|<!---Descripción--->    Código de tipo de moneda en la cual se emite la factura electrónica
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>3
|<!---Formato--->        style="text-align:center"| Catálogo N° 02
|<!---Obligatorio--->    style="text-align:center;"| F, B, NC, ND
|<!---Opcional--->      style="text-align:center;"| 
|-
|<!---Campo--->          style="color: blue; text-align:center"| tipoCambio
|<!---Descripción--->    Tipo de cambio del tipo de moneda con respecto al Sol (S/) en caso de usar una moneda diferente a ésta
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(3,5)
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"|  F, B, NC, ND
|-
|-
|}
|}

Revisión del 00:32 15 jul 2021

El método Enviar permite la generación de los siguientes documentos:

  • Factura Electrónica
  • Boleta de Venta Electrónica
  • Nota de Crédito Electrónica
  • Nota de Débito Electrónica

NOTA: El registro de los campos aparece en orden alfabético en este artículo, tal como en el objeto del método

Descripción Método para enviar documentos (factura, boleta de venta, nota de crédito y nota de débito) a OSE/SUNAT
Respuesta Exitosa Código de retorno | Estatus | Hora | Mensaje | Serie y correlativo del documento | XML timbrado


Leyenda

Tipo de Longitud

A: Carácter alfabético
N: Carácter numérico
AN: Carácter alfanumérico
A|i: Carácter alfabético de longitud fija i
N|i: Carácter numérico de longitud fija i
AN|i: Carácter alfanumérico de longitud fija i
A|…j: Valor de hasta j caracteres alfabéticos
N|…j: Valor de hasta j caracteres numéricos
AN|…j: Valor de hasta j caracteres alfanuméricos

Recurrencia de la línea

  • Si contiene un 0..1 es opcional, pero aparece una única vez de ser el caso aplicable
  • Si contiene un 0..n es opcional, pero puede haber varias veces esta línea
  • Si contiene un 1 es una línea obligatoria que sólo puede aparecer una vez
  • Si contiene un 1..n es una línea obligatoria que puede haber varias veces

Obligatoriedad del campo

Obl.: El envío del campo es obligatorio
Opc.: El envío del campo es opcional

Documentos afectados por el campo

F: Factura
B: Boleta
NC: Nota de crédito
ND: Nota de débito

Comprobante

Ubicación en Objeto: Enviar/DocumentoElectronico
Cantidad de Campos: 8
Descripción General: Contiene información del comprobante electrónico
NOTA: Los nodos son hijos directos del nodo DocumentoElectronico/
Recurrencia de la línea: 1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
tipoDocumento Tipo de documento en curso AN|2 Catálogo N° 01 F, B, NC, ND
codigoTipoOperacion Código de tipo de operación AN|2 Catálogo N° 51 F, B, NC, ND
serie Serie del documento AN|4 XLLL, donde X puede valer:

F: Factura o Notas asociadas
B: Boleta o Notas asociadas

F, B, NC, ND
correlativo Correlativo del documento N|...8 F, B, NC, ND
fechaEmision Fecha de emisión del documento en curso AN|10 YYYY-MM-DD F, B, NC, ND
fechaVencimiento Fecha de vencimiento del documento AN|10 YYYY-MM-DD F, B
horaEmision Hora de emisión del documento en curso AN|8 hh:mm:ss F, B, NC, ND
idTransaccion Permite tener un control adicional con un ID interno, de lo que envían y reciben.

Aparece luego en el SOAP Response

AN|...20 F, B, NC, ND

Anticipos

Ubicación en Objeto: Enviar/DocumentoElectronico/Anticipo
Cantidad de Campos: 8
Descripción General: Contiene información del pago anticipado
Recurrencia de la línea: 0...n
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
codigoTipoMoneda Código de tipo de moneda del monto del anticipo AN|3 Catálogo N° 02 F, B
fecha Fecha del pago AN|10 YYYY-MM-DD F, B
identificador Identificador del pago N|2 Ordinal del pago (01, 02...etc.) F, B
montoPrepagado Monto prepagado o anticipado N|(15,2) F, B
montoValorAnticipo Monto del valor del anticipo N|(15,2) F, B
numerodocumento Serie y número de comprobante del anticipo N|...23 NNNN-NNNNNNNN

FNNN-NNNNNNNN
Para el caso de reorganización de empresas
incluye el RUC con el siguiente formato:
RRRRRRRRRRR-NNNN-NNNNNNNN
RRRRRRRRRRR -FNNN-NNNNNNNN

F, B
rucEmisorComprobante Número de RUC del emisor del comprobante de anticipo AN|11 F, B
tipodocumento Tipo de comprobante del anticipo N|2 Catálogo N° 12 F, B

Nota: Si se envía información en un campo, todos los demás deben enviarse


Cargos Globales

Ubicación en Objeto: Enviar/DocumentoElectronico/cargosGlobales/per:cargosGlobales
Cantidad de Campos: 4
Descripción General: Contiene información de los cargos que afectan al total del documento
Recurrencia de la línea: 0...1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
baseImponible Monto de base imponible de cargo global N|(12,2) F, B, NC, ND
monto Monto total del cargo global. Forma parte de los totales del documento N|(12,2) F, B, NC, ND
motivo Código del motivo del cargo AN|...2 Catálogo N° 53 F, B, NC, ND
porcentaje Factor de porcentaje del cargo global N|(3,5) F, B, NC, ND

Nota: Si se envía información en un campo, todos los demás deben enviarse

Descuentos Globales

Ubicación en Objeto: Enviar/DocumentoElectronico/descuentosGlobales
Cantidad de Campos: 4
Descripción General: Contiene información de los descuentos que afectan al total del documento
Recurrencia de la línea: 0...1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
baseImponible Monto de base imponible de descuento global N|(12,2) F, B, NC, ND
monto Monto total del descuento global. Forma parte de los totales del documento N|(12,2) F, B, NC, ND
motivo Código del motivo del descuento AN|...2 Catálogo N° 53 F, B, NC, ND
porcentaje Factor de porcentaje del descuento global N|(3,5) F, B, NC, ND

Nota: Si se envía información en un campo, todos los demás deben enviarse

Detracciones

Ubicación en Objeto: Enviar/DocumentoElectronico/Detraccion
Cantidad de Campos: 5
Descripción General: Información base de la detracción. Contiene información del pago que acredita la detracción
Recurrencia de la línea: 0...n
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
codigo Código del bien o producto sujeto a detracción N|2 Catálogo N° 54 F, B
medioPago Medio de pago de la detracción AN|3 Catálogo N° 59 F, B
monto Monto de la detracción N|(12,2) F, B
numCuentaBancodelaNacion Número Cuenta del Banco de la Nación AN|...100 F, B
porcentaje Porcentaje de la detracción N|(3,2) F, B

Nota: Si se envía información en un campo, todos los demás deben enviarse

Detracciones - Recursos Hidrobiológicos

Ubicación en Objeto: Enviar/DocumentoElectronico/Detraccion/recursosHidrobiologicos
Cantidad de Campos: 8
Descripción General: Contiene información de la detracción, referente a recursos hidrobiológicos
Recurrencia de la línea: 0...1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
cantidadEspecie Cantidad de la especie vendida AN|...15 F, B
codigo Código de identificación del concepto tributario AN|4 Catálogo N° 55 F, B
descripcionEspecie Descripción del tipo de la especie vendida AN|...100 F, B
fechaDescarga Fecha de descarga de la especie AN|10 YYYY-MM-DD F, B
lugarDescarga Lugar de descarga de la especie AN|...200 F, B
matricula Matrícula de la embarcación pesquera AN|...15 F, B
nombre Nombre de la embarcación pesquera AN|...50 F, B
unidadMedida Unidad de medida para la especie vendida AN|...3 TNE (Valor fijo) F, B

Detracciones - Servicio de Transporte de Carga

Ubicación en Objeto: Enviar/DocumentoElectronico/Detraccion/servicioTransporteCarga
Cantidad de Campos: 8
Descripción General: Contiene información de la detracción, referente a servicios de transporte de carga
Recurrencia de la línea: 0...1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
detalledelViaje Información detallada del viaje AN|...500 F, B
direccionDestino Dirección detallada del destino AN|...200 F, B
direccionOrigen Dirección detallada del origen AN|...200 F, B
referenciaCargaEfectiva Valor referencial sobre la carga efectiva N|(12,2) F, B
referenciaCargaNominal Valor referencial sobre la carga útil nominal N|(12,2) F, B
referenciaServicio Valor referencial del servicio de transporte N|(12,2) F, B
ubigeoDestino Código de UBIGEO de destino AN|6 Catálogo N° 13 F, B
ubigeoOrigen Código de UBIGEO de origen AN|6 Catálogo N° 13 F, B

Detracciones - Servicio de Transporte de Carga - Detalle de Tramos

Ubicación en Objeto: Enviar/DocumentoElectronico/Detraccion/servicioTransporteCarga/detalleTramos
Cantidad de Campos: 5
Descripción General: Contiene información de la detracción, referente al detalle de los tramos para servicios de transporte de cargas, de corresponder
Recurrencia de la línea: 0...n
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
descripcion Descripción del tramo recorrido AN|...100 F, B
identificador Identificador del tramo N|2 F, B
puntoDestino Punto de destino del viaje (código UBIGEO de destino) AN|6 Catálogo N° 13 F, B
puntoOrigen Punto de origen del viaje (código UBIGEO de origen) AN|6 Catálogo N° 13 F, B
valorPreliminarReferencia Valor preliminar referencial sobre la carga efectiva (por el tramo virtual recorrido) AN|...15 F, B


Detracciones - Servicio de Transporte de Carga - Detalle del (los) Vehículo (s)

Ubicación en Objeto: Enviar/DocumentoElectronico/Detraccion/servicioTransporteCarga/detalleVehiculo
Cantidad de Campos: 6
Descripción General: Contiene información de la detracción, referente al detalle de los vehículos para servicios de transporte de cargas
Recurrencia de la línea: 0...1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
cargaEfectiva Valor de la carga efectiva en TM del vehículo N|(12,2) F, B
cargaUtil Valor de la Carga útil en TM del vehículo N|(12,2) F, B
configuracionVehicular Configuración vehicular del vehículo AN|...15 Según Códigos del D.S. 058-2003-MTC y modificatorias F, B
factordeRetorno Indicador de factor de retorno de viaje AN|2 SI: para indicar retorno

NO: caso contrario

F, B
valorPreliminar Valor preliminar referencial por carga útil nominal (tratándose de más de 1 vehículo) N|(12,2) F, B
valorReferencial Valor referencial por TM AN|5 SI: para indicar retorno

NO: caso contrario

F, B


Emisor

Ubicación en Objeto: Enviar/DocumentoElectronico/Emisor
Cantidad de Campos: 11
Descripción General: Contiene información base del emisor del documento electrónico. El resto de los campos solicitados en el XML se toman de lo que esté registrado en el Portal de Emisión
Recurrencia de la línea: 0...1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
codigoPais Código del país del domicilio fiscal AN|2 F, B, NC, ND
departamento Departamento del domicilio fiscal AN|...30 F, B, NC, ND
distrito Distrito del domicilio fiscal AN|...30 F, B, NC, ND
domicilioFiscal Dirección del domicilio fiscal AN|...100 F, B, NC, ND
lugarExpedicion Código asignado por SUNAT para el establecimiento anexo declarado en el RUC N|4 F, B, NC, ND
nombreComercial Nombre comercial del emisor , en caso de existir AN|...200 F, B, NC, ND
provincia Provincia del domicilio fiscal AN|...30 F, B, NC, ND
ruc RUC del emisor N|11 F, B, NC, ND
serialCaja Serial numérico del equipo o aplicación en caso de que el emisor utilice un medio diferente al WS AN|...15 F, B, NC, ND ubigeo Código UBIGEO del domicilio fiscal AN|6 F, B, NC, ND
urbanizacion Urbanización del domicilio fiscal AN|...25 F, B, NC, ND

Delivery (Entrega de bien o servicio)

Ubicación en Objeto: Enviar/DocumentoElectronico/entregaBienoServicio
Cantidad de Campos: 9
Descripción General: Contiene información de la dirección del lugar en el que se entrega el bien, siempre que este dato no obre como punto de llegada en la guía de remisión
Recurrencia de la línea: 0...1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
codigoPais Código de país de la dirección para la entrega AN|2 Catálogo N° 04 F, B
departamento Departamento de la dirección para la entrega AN|...30 F, B
direccion Dirección para la entrega AN|...200 F, B
distrito Distrito de la dirección para la entrega AN|...30 F, B
lugarExpedicion Código asignado por SUNAT para el establecimiento anexo declarado en el RUC AN|2 Catálogo N° 04 F, B
paisUsoServicio País de uso del servicio o bien entregado AN|2 Catálogo N° 04 F, B
provincia Provincia de la dirección para la entrega AN|...30 F, B
ubigeo Ubigeo de la dirección para la entrega AN|6 Catálogo N° 13 F, B
urbanizacion Urbanización de la dirección para la entrega AN|...25 F, B

Factura Guía

Ubicación en Objeto: Enviar/DocumentoElectronico/facturaGuia
Cantidad de Campos: 5
Descripción General: Contiene la información base de la guía de remisión cuando se genera una factura
Recurrencia de la línea: 0...1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
cantidadVehiculos Información de vehículos secundarios AN|...8 F
fechaInicio Fecha de inicio del traslado o fecha de entrega de bienes al transportista AN|10 YYYY-MM-DD F
motivoTraslado Código de motivo de traslado AN|2 Catálogo N° 20 F
pesoBrutototal Peso bruto total de la factura, indicando la unidad de medida según Catálogo N° 03 AN|...15 XXXXX/ZZZ, Donde

X...X: hace referencia al peso
Z...Z: hace referencia a la unidad de medida

F
subcontrato Indicador de subcontratación AN|2 SI: Si es subcontratado

NO: caso contrario

F

Nota: Si se envía información en un campo, todos los demás deben enviarse

Factura Guía - Información de Partida

Ubicación en Objeto: Enviar/DocumentoElectronico/facturaGuia/informacionPartida
Cantidad de Campos: 2
Descripción General: Contiene la información de la guía de remisión cuando se genera una factura, apartado origen.
Recurrencia de la línea: 0...1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
direccion Dirección punto de llegada - Dirección completa y detallada AN|...200 F
ubigeo Dirección punto de partida - Código de ubigeo AN|6 Catálogo N° 13 F

Factura Guía - Información de Vehículos

Ubicación en Objeto: Enviar/DocumentoElectronico/facturaGuia/informacionVehiculo
Cantidad de Campos: 6
Descripción General: Contiene la información base de los vehículos involucrados en la guía de remisión, cuando se genera una factura
Recurrencia de la línea: 0...1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
constanciaInscripcion Número de constancia de inscripción del vehículo o certificado de habilitación vehicular AN|...40 F
documentacionTransportista Tipo y Número de documento de identidad del transportista o transportista contratante AN|...12 XXXXXXXX/N donde:

X: número de identidad
N: tipo de documento

F
modalidad Modalidad del transporte AN|2 Catálogo N° 18 F
placaVehiculo Información de vehículo principal - Número de placa. AN|...8 F
razonSocialTransportista Apellidos y nombres o razón social del transportista o transportista contratante AN|...200 F
registroMTC Número de registro MTC (Ministerio de Transportes y Comunicaciones) AN|...20 F

Nota: Si se envía información en un campo, todos los demás deben enviarse

Factura Guía - Información de Llegada

Ubicación en Objeto: Enviar/DocumentoElectronico/facturaGuia/informacionLlegada
Cantidad de Campos: 6
Descripción General: Contiene la información de llegada en la guía de remisión, cuando se genera una factura
Recurrencia de la línea: 0...1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
departamento Dirección punto de llegada - Departamento AN|...200 F
direccion Dirección punto de llegada - Dirección completa y detallada AN|...200 F
distrito Dirección punto de llegada - Distrito AN|...200 F
provincia Dirección punto de llegada - Provincia AN|...200 F
ubigeo Dirección punto de llegada - Código de ubigeo AN|6 Catálogo N° 13 F
urbanizacion Dirección punto de llegada - Urbanización AN|...200 F

Nota: Si se envía información en un campo, todos los demás deben enviarse

Factura Negociable (R.S. 193-2020/SUNAT)

Factura Negociable - Forma de Pago

Ubicación en Objeto: Enviar/DocumentoElectronico/facturaNegociable
Cantidad de Campos: 2
Descripción General: Contiene campos generales de Forma de pago para incluir factura negociable
Recurrencia de la línea: 1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
modoPago Indicador para el valor ‘FormaPago’ AN|...7 Contado

Credito

F NC
montoNetoPendiente Si el campo 1 es ‘Credito’, debe reportarse el monto por pagar

Si el campo 1 es ‘Contado’, se deja vacío

N|(12,2) F, NC

NOTA: Únicamente para Nota de Crédito tipo 13

Factura Negociable - Cuotas

Ubicación en Objeto: Enviar/DocumentoElectronico/facturaNegociable/cuotasFactura/cuotaFactura
Cantidad de Campos: 3
Descripción General: Contiene campos específicos de las cuotas de Forma de pago para incluir factura negociable (sólo si es a crédito)
Recurrencia de la línea: 0...n
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
fechaPagoCuota Fecha de pago de la cuota n-sima AN|10 YYYY-MM-DD F, NC
identificadorCuota Identificador del número de la cuota AN|8 Cuota<NNN>
Ej: Cuota001
F, NC
montoPagoCuota Monto de pago de la cuota n-sima N|(12,2) F, NC

NOTA: Únicamente para Nota de Crédito tipo 13

Factura Negociable - Retención del IGV

Ubicación en Objeto: Enviar/DocumentoElectronico/facturaNegociable/cuotasFactura/retencionFactura/retencionFactura
Cantidad de Campos: 3
Descripción General: Campos específicos de las retenciones de IGV de Forma de pago para incluir factura negociable
Recurrencia de la línea: 0...1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
importeOperacion Monto del importe de la operación N|(12,2) F
montoImporte Monto del importe de la retención N|(12,2) F
porcentajeRetencion Porcentaje de la retención, expresado como factor N|(3,5) F

Fondo de Inclusión Social Energético

Ubicación en Objeto: Enviar/DocumentoElectronico/fondoIncSocEnergetico
Cantidad de Campos: 3
Descripción General: Contiene información del pago que acredita el cargo/descuento por FISE
Recurrencia de la línea: 0...n
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
motivo Código tipo de monto AN|2 Catálogo N° 53 F, B
baseImponible Base imponible para la percepción N|(12,2) F, B
monto Monto del cargo/descuento por FISE N|(12,2) F, B

Gastos Hipotecarios Primera Vivienda - Pago de Créditos No Hipotecarios

Ubicación en Objeto: Enviar/DocumentoElectronico/gastosHipotecarios
Cantidad de Campos: 11
Descripción General: Contiene la información referente a para adquisición o construcción de primera vivienda inscrita en Registros Públicos. Coinciden con los conceptos establecidos en el catálogo N°55 del 7001 al 7009.
Recurrencia de la línea: 0...n
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
codigoUbigeo Código de UBIGEO de ubicación de la vivienda AN|6 Catálogo N° 13 F, NC, ND
departamento Dirección completa y detallada de la vivienda - Departamento AN|...30 F, NC, ND
direccionCompleta Dirección completa y detallada de la vivienda AN|...200 F, NC, ND
distrito Dirección completa y detallada de la vivienda - Distrito AN|...30 F, NC, ND
fechaOtorgamientoCredito Fecha en que fue otorgado el crédito AN|10 YYYY-MM-DD F, NC, ND
indicadorPrimeraVivienda Código de indicador de primera vivienda AN|1 Catálogo N° 27 F, NC, ND
montoOtorgadoCapital Monto del crédito otorgado N|(12,2) F, NC, ND
numContrato Identificador del contrato de adquisición o construcción de primera

vivienda inscrita en Registros Públicos

AN|...100 F, NC, ND
partidaRegistral Número de la Partida Registral AN|...50 F, NC, ND
provincia Dirección completa y detallada de la vivienda - Provincia AN|...30 F, NC, ND
tipoPrestamo Código del tipo de préstamo (crédito) AN|1 Catálogo N° 26 F, NC, ND
urbanizacion Dirección completa y detallada de la vivienda - Urbanización AN|...25 F, NC, ND

Líneas Adicionales - Leyendas

Ubicación en Objeto: Enviar/DocumentoElectronico/lineasAdicionales
Cantidad de Campos: 2
Descripción General: Contiene la información adicional a enviar a SUNAT en el archivo XML, conforme al Catálogo N° 52, dispuesto para tal fin
Recurrencia de la línea: 0...n
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
codigo Código a usar para la leyenda AN|4 Catálogo N° 52 F, B, NC, ND
valor Leyenda a enviar como información adicional AN|...100 F, B, NC, ND

Migración de Documentos Autorizados

Migración de Documentos Autorizados - Carta Porte Aéreo

Ubicación en Objeto: Enviar/DocumentoElectronico/migracionDocsAutorizados/cartaPorteAereo
Cantidad de Campos: 4
Descripción General: Contiene la información referente a la migración de documentos autorizados, específicamente a Carta de Porte Aéreo
Recurrencia de la línea: 0...n
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
direccionDestino Dirección detallada de destino AN|...200 F, B
direccionOrigen Dirección detallada de origen AN|...200 F, B
ubigeoDestino Código de UBIGEO de destino AN|6 Catálogo N° 13 F, B
ubigeoOrigen Código de UBIGEO de origen AN|6 Catálogo N° 13 F, B

Migración de Documentos Autorizados - BVME para transporte ferroviario de pasajeros

Ubicación en Objeto: Enviar/DocumentoElectronico/migracionDocsAutorizados/BVMETransporteFerroviario
Cantidad de Campos: 13
Descripción General: Contiene la información referente a la migración de documentos autorizados, específicamente al transporte ferroviario de pasajeros
Recurrencia de la línea: 0...n
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
RUCAgenteVentas Código de Tipo y número de documento de identidad del agente de ventas, con formato. Sólo RUC AN|13 6/NNNNNNNNNNN F
direccionDestino Dirección detallada de destino AN|...200 F
direccionOrigen Dirección detallada de Origen AN|...200 F
formaPago Forma de pago del pasajero AN|3 Catálogo N° 59 F
horaProgramada Hora programada del inicio de viaje AN|8 hh:mm:ss F
inicioViaje Día programado del inicio de viaje AN|10 YYYY-MM-DD F
numDocPasajero Número de documento de identidad del pasajero AN|...28 F
numeroAsiento Número de asiento del pasajero AN|...100 F
numeroAutorizacionTransacción Número de autorización de la transacción y el sistema de tarjeta de crédito y/o débito AN|...30 F
razonSocialPasajero Nombre o Razón social del pasajero AN|...100 F
tipoDocPasajero Código de Tipo de documento de identidad del pasajero AN|...30 Catálogo N° 06 F
ubigeoDestino Código de UBIGEO de destino N|6 Catálogo N° 13 F
ubigeoOrigen Código de Ubigeo de origen N|6 Catálogo N° 13 F

Migración de Documentos Autorizados - Pago de Regalía Petrolera

Ubicación en Objeto: Enviar/DocumentoElectronico/migracionDocsAutorizados/pagoRegaliaPetrolera
Cantidad de Campos: 5
Descripción General: Contiene la información referente a la migración de documentos autorizados, específicamente a Pago de regalía petrolera
Recurrencia de la línea: 0...n
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
areaContrato Área de contrato - Lote AN|...10 F, B
decreto Número de Decreto Supremo de aprobación del contrato AN|...30 F, B
fechaFinPago Fin del período de pago del concepto AN|10 YYYY-MM-DD F, B
fechaInicioPago Inicio del período de pago del concepto AN|10 YYYY-MM-DD F, B
fechaPago Fecha de realización del pago AN|10 YYYY-MM-DD F, B

Operaciones Turísticas

Operaciones Turísticas - Información de Hospedaje

Ubicación en Objeto: Enviar/DocumentoElectronico/operacionesTuristicas/Hospedaje
Cantidad de Campos: 10
Descripción General: Contiene la información referente a las operaciones turísticas, específicamente relacionadas con hospedaje
Recurrencia de la línea: 0...n
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
codigoPaisEmisionPasaporte Código de país de emisión del pasaporte AN|2 Catálogo N° 04 F, B
codigoPaisResidenciaHuesped Código de país de residencia del huésped AN|2 Catálogo N° 04 F, B
diasPermanencia Días de permanencia en el establecimiento N|...4 F, B
fechaConsumo Fecha de consumo del huésped AN|10 YYYY-MM-DD F, B
fechaIngresoHotel Fecha de ingreso del huésped al establecimiento AN|10 YYYY-MM-DD F, B
fechaIngresoPais Fecha de ingreso del huésped al país AN|10 YYYY-MM-DD F, B
fechaSalidaHotel Fecha de salida del huésped al establecimiento AN|10 YYYY-MM-DD F, B
numDocumentoHuesped Número de documento del huésped AN|...30 F, B
razonSocialHuesped Apellidos y nombres, denominación o razón social del huésped AN|...100 F, B
tipoDocumentoHuesped Tipo de documento del huésped AN|...15 Catálogo N° 06 F, B

Operaciones Turísticas - Información de Paquete Turístico

Ubicación en Objeto: Enviar/DocumentoElectronico/operacionesTuristicas/paqueteTuristico
Cantidad de Campos: 4
Descripción General: Contiene la información referente a las operaciones turísticas, específicamente para paquetes turísticos
Recurrencia de la línea: 0...n
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
codigoPaisEmisionPasaporte Código de país de emisión del pasaporte AN|2 Catálogo N° 04 F, B
numDocumentoHuesped Número de documento del huésped AN|...30 F, B
razonSocialHuesped Apellidos y nombres, denominación o razón social del turista AN|...100 F, B
tipoDocumentoHuesped Tipo de documento del huésped AN|...15 Catálogo N° 06 F, B

Operaciones Turísticas - Información de Transporte de Pasajeros

Ubicación en Objeto: Enviar/DocumentoElectronico/operacionesTuristicas/transportePasajeros
Cantidad de Campos: 10
Descripción General: Contiene la información referente a las operaciones turísticas, específicamente transporte de pasajeros
Recurrencia de la línea: 0...n
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
direccionDestino Dirección detallada de destino AN|...200 F, B
direccionOrigen Dirección detallada de origen AN|...200 F, B
fechaHoraInicioProgramado Fecha y hora de inicio programado AN|19 YYYY-MM-DD hh:mm:ss F, B
infoManifiestoPasajero Información de manifiesto de pasajero AN|...100 F, B
numAsiento Número de asiento del pasajero AN|...100 F, B
numIDPasajero Número de documento del huésped AN|...30 F, B
razonSocialPasajero Nombres y apellidos del pasajero AN|...100 F, B
tipoIDPasajero Tipo de documento del huésped AN|...30 Catálogo N° 06 F, B
ubigeoDestino Ciudad o lugar de destino (código UBIGEO) N|6 Catálogo N° 13 F, B
ubigeoOrigen Ciudad o lugar de origen (código UBIGEO) N|6 Catálogo N° 13 F, B

Pago

Ubicación en Objeto: Enviar/DocumentoElectronico/pago
Cantidad de Campos: 5
Descripción General: Contiene información del pago del documento
Recurrencia de la línea: 1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
fechaFin Fecha de fin de ciclo de facturación AN|10 YYYY-MM-DD F, B, NC, ND
fechaInicio Fecha de inicio de ciclo de facturación AN|10 YYYY-MM-DD F, B, NC, ND
metodoPago Medio de pago utilizado en el documento N|3 Catálogo N° 59 F, B, NC, ND
moneda Código de tipo de moneda en la cual se emite la factura electrónica AN|3 Catálogo N° 02 F, B, NC, ND
tipoCambio Tipo de cambio del tipo de moneda con respecto al Sol (S/) en caso de usar una moneda diferente a ésta N|(3,5) F, B, NC, ND