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
(Página creada con «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…»)
 
Línea 4: Línea 4:
* Nota de Crédito Electrónica
* Nota de Crédito Electrónica
* Nota de Débito 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
{| class="wikitable" style="margin: auto;"
! style="text-align:left;"  style="color:red"| Descripción
! ''Método para enviar documentos (factura, boleta de venta, nota de crédito y nota de débito) a OSE/SUNAT''
|-
! style="text-align:left;"  style="color:red"| Respuesta Exitosa
! ''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==
===Tipo de Longitud ===
'''A''': Carácter alfabético <br/>
'''N''': Carácter numérico <br/>
'''AN''': Carácter alfanumérico <br/>
'''A|i''': Carácter alfabético de longitud fija '''i''' <br/>
'''N|i''': Carácter numérico de longitud fija '''i''' <br/>
'''AN|i''': Carácter alfanumérico de longitud fija '''i''' <br/>
'''A|…j''': Valor de hasta '''j''' caracteres alfabéticos <br/>
'''N|…j''': Valor de hasta '''j''' caracteres numéricos <br/>
'''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 <br/>
'''Opc.''': El envío del campo es opcional
===Documentos afectados por el campo===
'''F''': Factura <br/>
'''B''': Boleta <br/>
'''NC''': Nota de crédito <br/>
'''ND''': Nota de débito
<!----COMPROBANTE---->
==Comprobante==
{| style="text-align:left;"
!Ubicación en Objeto:
! style="color: blue" | Enviar/DocumentoElectronico
|-
!Cantidad de Campos:
!style="text-align:left;"|8
|-
!Descripción General:
!style="text-align:left;"|Contiene información del comprobante electrónico
|-
!NOTA:
!style="text-align:left;"| Los nodos son hijos directos del nodo <span style="color: blue;">DocumentoElectronico/</span>
|-
!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"| tipoDocumento
|<!---Descripción--->    Tipo de documento en curso
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>2
|<!---Formato--->        style="text-align:center"|  Catálogo N° 01
|<!---Obligatorio--->    style="text-align:center;"| F, B, NC, ND
|<!---Opcional--->      style="text-align:center;"|
|- 
|<!---Campo--->          style="color: blue; text-align:center"| codigoTipoOperacion
|<!---Descripción--->    Código de tipo de operación                       
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>2
|<!---Formato--->        style="text-align:center"|  Catálogo N° 51 
|<!---Obligatorio--->    style="text-align:center;"| F, B, NC, ND           
|<!---Opcional--->      style="text-align:center;"|   
|-
|<!---Campo--->          style="color: blue; text-align:center"| serie
|<!---Descripción--->    Serie del documento
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>4
|<!---Formato--->        style="text-align:center"| XLLL, donde X puede valer: <br/>
F: Factura o Notas asociadas <br/>
B: Boleta o Notas asociadas
|<!---Obligatorio--->    style="text-align:center;"| F, B, NC, ND
|<!---Opcional--->      style="text-align:center;"|
|- 
|<!---Campo--->          style="color: blue; text-align:center"| correlativo
|<!---Descripción--->    Correlativo del documento                         
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>...8
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"| F, B, NC, ND               
|<!---Opcional--->      style="text-align:center;"|
|-
|<!---Campo--->          style="color: blue; text-align:center"| fechaEmision
|<!---Descripción--->    Fecha de emisión del documento en curso
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>10
|<!---Formato--->        style="text-align:center"| YYYY-MM-DD
|<!---Obligatorio--->    style="text-align:center;"| F, B, NC, ND
|<!---Opcional--->      style="text-align:center;"|     
|-
|<!---Campo--->          style="color: blue; text-align:center"| fechaVencimiento
|<!---Descripción--->    Fecha de vencimiento del documento
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>10
|<!---Formato--->        style="text-align:center"| YYYY-MM-DD
|<!---Obligatorio--->    style="text-align:center;"| F, B
|<!---Opcional--->      style="text-align:center;"|
|-
|<!---Campo--->          style="color: blue; text-align:center"| horaEmision
|<!---Descripción--->    Hora de emisión del documento en curso
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>8
|<!---Formato--->        style="text-align:center"| hh:mm:ss
|<!---Obligatorio--->    style="text-align:center;"| F, B, NC, ND
|<!---Opcional--->      style="text-align:center;"|
|-
|<!---Campo--->          style="color: blue; text-align:center"| idTransaccion
|<!---Descripción--->    Permite tener un control adicional con un ID interno, de lo que envían y reciben. <br/>
Aparece luego en el SOAP Response
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...20
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"| 
|<!---Opcional--->      style="text-align:center;"| F, B, NC, ND
|-
|}
<!----ANTICIPOS-------->
==Anticipos==
{| style="text-align:left;"
!Ubicación en Objeto:
! style="color: blue" | Enviar/DocumentoElectronico/Anticipo
|-
!Cantidad de Campos:
!style="text-align:left;"|8
|-
!Descripción General:
!style="text-align:left;"| : Contiene información del pago anticipado
|-
!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"| codigoTipoMoneda
|<!---Descripción--->    Código de tipo de moneda del monto del anticipo
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>3
|<!---Formato--->        style="text-align:center"|  Catálogo N° 02
|<!---Obligatorio--->    style="text-align:center;"|           
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| fecha
|<!---Descripción--->    Fecha del pago
|<!---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"| identificador
|<!---Descripción--->    Identificador del pago
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>2
|<!---Formato--->        style="text-align:center"| Ordinal del pago (01, 02...etc.)
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"|  F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| montoPrepagado
|<!---Descripción--->    Monto prepagado o anticipado
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(15,2)
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| montoValorAnticipo
|<!---Descripción--->    Monto del valor del anticipo
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(15,2)
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| numerodocumento
|<!---Descripción--->    Serie y número de comprobante del anticipo
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>...23
|<!---Formato--->        style="text-align:center"| NNNN-NNNNNNNN <br/>
FNNN-NNNNNNNN <br/>
Para el caso de reorganización de empresas <br/>
incluye el RUC con el siguiente formato: <br/>
RRRRRRRRRRR-NNNN-NNNNNNNN <br/>
RRRRRRRRRRR -FNNN-NNNNNNNN
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| rucEmisorComprobante
|<!---Descripción--->    Número de RUC del emisor del comprobante de anticipo
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>11
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"|  F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| tipodocumento
|<!---Descripción--->    Tipo de comprobante del anticipo
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>2
|<!---Formato--->        style="text-align:center"| Catálogo N° 12
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"|  F, B
|-
|}
'''Nota''': Si se envía información en un campo, todos los demás deben enviarse
<!----CARGOS GLOBALES---->
==Cargos Globales==
{| style="text-align:left;"
!Ubicación en Objeto:
! style="color: blue" | Enviar/DocumentoElectronico/cargosGlobales/per:cargosGlobales
|-
!Cantidad de Campos:
!style="text-align:left;"|4
|-
!Descripción General:
!style="text-align:left;"| : Contiene información de los cargos que afectan al total del documento
|-
!Recurrencia de la línea:
! 0...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"| baseImponible
|<!---Descripción--->    Monto de base imponible de cargo global
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
|<!---Formato--->        style="text-align:center"| 
|<!---Obligatorio--->    style="text-align:center;"|           
|<!---Opcional--->      style="text-align:center;"| F, B, NC, ND
|-
|<!---Campo--->          style="color: blue; text-align:center"| monto
|<!---Descripción--->    Monto total del cargo global. '''Forma parte de los totales del documento'''
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|           
|<!---Opcional--->      style="text-align:center;"|  F, B, NC, ND 
|-
|<!---Campo--->          style="color: blue; text-align:center"| motivo
|<!---Descripción--->    Código del motivo del cargo
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...2
|<!---Formato--->        style="text-align:center"| Catálogo N° 53
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"|  F, B, NC, ND 
|-
|<!---Campo--->          style="color: blue; text-align:center"| porcentaje
|<!---Descripción--->    Factor de porcentaje del cargo global
|<!---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
|-
|}
'''Nota''': Si se envía información en un campo, todos los demás deben enviarse
<!----DESCUENTOS GLOBALES---->
==Descuentos Globales==
{| style="text-align:left;"
!Ubicación en Objeto:
! style="color: blue" | Enviar/DocumentoElectronico/descuentosGlobales
|-
!Cantidad de Campos:
!style="text-align:left;"|4
|-
!Descripción General:
!style="text-align:left;"| : Contiene información de los descuentos que afectan al total del documento
|-
!Recurrencia de la línea:
! 0...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"| baseImponible
|<!---Descripción--->    Monto de base imponible de descuento global
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
|<!---Formato--->        style="text-align:center"| 
|<!---Obligatorio--->    style="text-align:center;"|           
|<!---Opcional--->      style="text-align:center;"| F, B, NC, ND
|-
|<!---Campo--->          style="color: blue; text-align:center"| monto
|<!---Descripción--->    Monto total del descuento global. '''Forma parte de los totales del documento'''
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|           
|<!---Opcional--->      style="text-align:center;"|  F, B, NC, ND 
|-
|<!---Campo--->          style="color: blue; text-align:center"| motivo
|<!---Descripción--->    Código del motivo del descuento
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...2
|<!---Formato--->        style="text-align:center"| Catálogo N° 53
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"|  F, B, NC, ND 
|-
|<!---Campo--->          style="color: blue; text-align:center"| porcentaje
|<!---Descripción--->    Factor de porcentaje del descuento global
|<!---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
|-
|}
'''Nota''': Si se envía información en un campo, todos los demás deben enviarse
<!----DETRACCIONES-------->
==Detracciones==
{| style="text-align:left;"
!Ubicación en Objeto:
! style="color: blue" | Enviar/DocumentoElectronico/Detraccion
|-
!Cantidad de Campos:
!style="text-align:left;"|5
|-
!Descripción General:
!style="text-align:left;"| Información base de la detracción. Contiene información del pago que acredita la detracción
|-
!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"| codigo
|<!---Descripción--->    Código del bien o producto sujeto a detracción
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>2
|<!---Formato--->        style="text-align:center"|  Catálogo N° 54
|<!---Obligatorio--->    style="text-align:center;"|           
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| medioPago
|<!---Descripción--->    Medio de pago de la detracción
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>3
|<!---Formato--->        style="text-align:center"|  Catálogo N° 59
|<!---Obligatorio--->    style="text-align:center;"|           
|<!---Opcional--->      style="text-align:center;"|  F, B 
|-
|<!---Campo--->          style="color: blue; text-align:center"| monto
|<!---Descripción--->    Monto de la detracción
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"|  F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| numCuentaBancodelaNacion
|<!---Descripción--->    Número Cuenta del Banco de la Nación
|<!---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"| porcentaje
|<!---Descripción--->    Porcentaje de la detracción
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(3,2)
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|}
'''Nota''': Si se envía información en un campo, todos los demás deben enviarse
<!----DETRACCIONES - RECURSOS HIDROBIOLOGICOS-------->
===Detracciones - Recursos Hidrobiológicos===
{| style="text-align:left;"
!Ubicación en Objeto:
! style="color: blue" | objeto: Enviar/DocumentoElectronico/Detraccion/recursosHidrobiologicos
|-
!Cantidad de Campos:
!style="text-align:left;"|8
|-
!Descripción General:
!style="text-align:left;"| : Contiene información de la detracción, referente a recursos hidrobiológicos
|-
!Recurrencia de la línea:
! 0...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"| cantidadEspecie
|<!---Descripción--->    Cantidad de la especie vendida
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...15
|<!---Formato--->        style="text-align:center"| 
|<!---Obligatorio--->    style="text-align:center;"|           
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| codigo
|<!---Descripción--->    Código de identificación del concepto tributario
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>4
|<!---Formato--->        style="text-align:center"|  Catálogo N° 55
|<!---Obligatorio--->    style="text-align:center;"|           
|<!---Opcional--->      style="text-align:center;"|  F, B 
|-
|<!---Campo--->          style="color: blue; text-align:center"| descripcionEspecie
|<!---Descripción--->    Descripción del tipo de la especie vendida
|<!---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"| fechaDescarga
|<!---Descripción--->    Fecha de descarga de la especie
|<!---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"| lugarDescarga
|<!---Descripción--->    Lugar de descarga de la especie
|<!---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"| matricula
|<!---Descripción--->    Matrícula de la embarcación pesquera
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...15
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| nombre
|<!---Descripción--->    Nombre de la embarcación pesquera
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...50
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| unidadMedida
|<!---Descripción--->    Unidad de medida para la especie vendida
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...3
|<!---Formato--->        style="text-align:center"|  TNE (Valor fijo)
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|}
<!----DETRACCIONES - SERVICIO DE TRANSPORTE DE CARGA-------->
===Detracciones - Servicio de Transporte de Carga===
{| style="text-align:left;"
!Ubicación en Objeto:
! style="color: blue" | objeto: Enviar/DocumentoElectronico/Detraccion/servicioTransporteCarga
|-
!Cantidad de Campos:
!style="text-align:left;"|8
|-
!Descripción General:
!style="text-align:left;"| : Contiene información de la detracción, referente a servicios de transporte de carga
|-
!Recurrencia de la línea:
! 0...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"| detalledelViaje
|<!---Descripción--->    Información detallada del viaje
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...500
|<!---Formato--->        style="text-align:center"| 
|<!---Obligatorio--->    style="text-align:center;"|           
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| direccionDestino
|<!---Descripción--->    Dirección detallada del 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 del 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"| referenciaCargaEfectiva
|<!---Descripción--->    Valor referencial sobre la carga efectiva
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| referenciaCargaNominal
|<!---Descripción--->    Valor referencial sobre la carga útil nominal
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| referenciaServicio
|<!---Descripción--->    Valor referencial del servicio de transporte
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| ubigeoDestino
|<!---Descripción--->    Código de UBIGEO de destino
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<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--->    Código de UBIGEO de origen
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>6
|<!---Formato--->        style="text-align:center"|  Catálogo N° 13
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|}

Revisión del 23:48 12 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: 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: 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