Diferencia entre revisiones de «Web Service REST - Método Enviar»
(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 |
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 |
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 |