Web Service REST - Método Enviar

De Facturacion Electronica de Peru
Ir a la navegación Ir a la búsqueda

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