Diferencia entre revisiones de «Integración Directa - Web Service SOAP»

De Facturacion Electronica de Peru
Ir a la navegación Ir a la búsqueda
Línea 82: Línea 82:


==Métodos del servicio web de The Factory HKA==
==Métodos del servicio web de The Factory HKA==
Se han implementado diferentes métodos que le permitirán realizar el proceso de facturación electrónica de manera rápida y eficaz. En la especificación de cada uno de ellos se indica la funcionalidad del método, el parámetro que se debe ingresar, y la estructura y ejemplos de las respuestas que puede obtener al ejecutar estos métodos.  
Se han implementado diferentes métodos que le permitirán realizar el proceso de facturación electrónica de manera rápida y eficaz. En la especificación de cada uno de ellos se indica la funcionalidad del método, el parámetro que se debe ingresar, y la estructura y ejemplos de las respuestas que puede obtener al ejecutar estos métodos. <br/>
 
El enlace de acceso a nuestro ambiente de pruebas es [https://demoint.thefactoryhka.com.pe/Service.svc https://demoint.thefactoryhka.com.pe/Service.svc].


==Método Enviar==
==Método Enviar==
Línea 93: Línea 93:
! ''Código de aceptación <nowiki>|</nowiki> Mensaje de aceptación <nowiki>|</nowiki> Serie - correlativo del documento y XML timbrado''
! ''Código de aceptación <nowiki>|</nowiki> Mensaje de aceptación <nowiki>|</nowiki> Serie - correlativo del documento y XML timbrado''
|}
|}
<!----CREDENCIALES---->
<!----CREDENCIALES---->
===Credenciales===
===Credenciales===
{| style="text-align:left;"
{| style="text-align:left;"
Línea 130: Línea 128:


<!----EMISOR---->
<!----EMISOR---->
===Emisor===
===Emisor===
{| style="text-align:left;"
{| style="text-align:left;"
Línea 185: Línea 182:


<!----RECEPTOR---->
<!----RECEPTOR---->
===Receptor===
===Receptor===
{| style="text-align:left;"
{| style="text-align:left;"
Línea 297: Línea 293:


<!----DELIVERY---->
<!----DELIVERY---->
===Delivery (Entrega de bien o servicio)===
===Delivery (Entrega de bien o servicio)===
{| style="text-align:left;"
{| style="text-align:left;"
Línea 380: Línea 375:


<!----COMPROBANTE---->
<!----COMPROBANTE---->
===Comprobante===
===Comprobante===
{| style="text-align:left;"
{| style="text-align:left;"
Línea 468: Línea 462:


<!----DATOS DE COMPROBANTE RELACIONADO---->
<!----DATOS DE COMPROBANTE RELACIONADO---->
===Datos de Comprobante Relacionado===
===Datos de Comprobante Relacionado===


<!----DATOS DE COMPROBANTE RELACIONADO - INFORMACIÓN RELACIONADA A FACTURAS---->
<!----DATOS DE COMPROBANTE RELACIONADO - INFORMACIÓN RELACIONADA A FACTURAS---->
====Datos de Comprobante relacionado – Información relacionada a Facturas====
====Datos de Comprobante relacionado – Información relacionada a Facturas====
{| style="text-align:left;"
{| style="text-align:left;"
Línea 538: Línea 530:


<!----DATOS DE COMPROBANTE RELACIONADO - INFORMACIÓN RELACIONADA A NOTAS DE CRÉDITO Y DÉBITO---->
<!----DATOS DE COMPROBANTE RELACIONADO - INFORMACIÓN RELACIONADA A NOTAS DE CRÉDITO Y DÉBITO---->
====Datos de Comprobante relacionado – Información relacionada a Notas de Crédito y Débito====
====Datos de Comprobante relacionado – Información relacionada a Notas de Crédito y Débito====
{| style="text-align:left;"
{| style="text-align:left;"
Línea 596: Línea 587:


<!----PRODUCTO---->
<!----PRODUCTO---->
===Producto===
===Producto===
{| style="text-align:left;"
{| style="text-align:left;"
Línea 723: Línea 713:


<!----PRODUCTO - IGV SOBRE ITEM---->
<!----PRODUCTO - IGV SOBRE ITEM---->
====Producto - IGV sobre ítem====
====Producto - IGV sobre ítem====
{| style="text-align:left;"
{| style="text-align:left;"
Línea 778: Línea 767:


<!----PRODUCTO - IVAP SOBRE ITEM---->
<!----PRODUCTO - IVAP SOBRE ITEM---->
====Producto - IVAP sobre ítem====
====Producto - IVAP sobre ítem====
{| style="text-align:left;"
{| style="text-align:left;"
Línea 833: Línea 821:


<!----PRODUCTO - ISC SOBRE ITEM---->
<!----PRODUCTO - ISC SOBRE ITEM---->
====Producto - ISC sobre ítem====
====Producto - ISC sobre ítem====
{| style="text-align:left;"
{| style="text-align:left;"
Línea 889: Línea 876:


<!----PRODUCTO - OTROS TRIBUTOS SOBRE ITEM - ICBPER---->
<!----PRODUCTO - OTROS TRIBUTOS SOBRE ITEM - ICBPER---->
====Producto - Otros Tributos sobre ítem - ICBPER====
====Producto - Otros Tributos sobre ítem - ICBPER====
{| style="text-align:left;"
{| style="text-align:left;"
Línea 948: Línea 934:


<!----PRODUCTO - DESCUENTOS SOBRE ITEM---->
<!----PRODUCTO - DESCUENTOS SOBRE ITEM---->
====Producto - Descuentos sobre ítem====
====Producto - Descuentos sobre ítem====
{| style="text-align:left;"
{| style="text-align:left;"
Línea 1004: Línea 989:


<!----PRODUCTO - CARGOS SOBRE ITEM---->
<!----PRODUCTO - CARGOS SOBRE ITEM---->
====Producto - Cargos sobre ítem====
====Producto - Cargos sobre ítem====
{| style="text-align:left;"
{| style="text-align:left;"
Línea 1060: Línea 1044:


<!----DESCUENTOS GLOBALES---->
<!----DESCUENTOS GLOBALES---->
===Descuentos Globales===
===Descuentos Globales===
{| style="text-align:left;"
{| style="text-align:left;"
Línea 1116: Línea 1099:


<!----CARGOS GLOBALES---->
<!----CARGOS GLOBALES---->
===Cargos Globales===
===Cargos Globales===
{| style="text-align:left;"
{| style="text-align:left;"
Línea 1172: Línea 1154:


<!----PERCEPCIONES-------->
<!----PERCEPCIONES-------->
===Percepciones===
===Percepciones===
{| style="text-align:left;"
{| style="text-align:left;"
Línea 1228: Línea 1209:


<!----DETRACCIONES-------->
<!----DETRACCIONES-------->
===Detracciones===
===Detracciones===
{| style="text-align:left;"
{| style="text-align:left;"
Línea 1291: Línea 1271:


<!----DETRACCIONES - RECURSOS HIDROBIOLOGICOS-------->
<!----DETRACCIONES - RECURSOS HIDROBIOLOGICOS-------->
====Detracciones - Recursos Hidrobiológicos====
====Detracciones - Recursos Hidrobiológicos====
{| style="text-align:left;"
{| style="text-align:left;"
Línea 1374: Línea 1353:


<!----DETRACCIONES - SERVICIO DE TRANSPORTE DE CARGA-------->
<!----DETRACCIONES - SERVICIO DE TRANSPORTE DE CARGA-------->
====Detracciones - Servicio de Transporte de Carga====
====Detracciones - Servicio de Transporte de Carga====
{| style="text-align:left;"
{| style="text-align:left;"
Línea 1457: Línea 1435:


<!----DETRACCIONES - SERVICIO DE TRANSPORTE DE CARGA - DETALLE DE TRAMOS-------->
<!----DETRACCIONES - SERVICIO DE TRANSPORTE DE CARGA - DETALLE DE TRAMOS-------->
=====Detracciones - Servicio de Transporte de Carga - Detalle de Tramos=====
=====Detracciones - Servicio de Transporte de Carga - Detalle de Tramos=====
{| style="text-align:left;"
{| style="text-align:left;"
Línea 1512: Línea 1489:


<!----DETRACCIONES - SERVICIO DE TRANSPORTE DE CARGA - DETALLE DEL (LOS) VEHICULO (S)-------->
<!----DETRACCIONES - SERVICIO DE TRANSPORTE DE CARGA - DETALLE DEL (LOS) VEHICULO (S)-------->
=====Detracciones - Servicio de Transporte de Carga - Detalle del (los) Vehículo (s)=====
=====Detracciones - Servicio de Transporte de Carga - Detalle del (los) Vehículo (s)=====
{| style="text-align:left;"
{| style="text-align:left;"
Línea 1583: Línea 1559:


<!----ANTICIPOS-------->
<!----ANTICIPOS-------->
===Anticipos===
===Anticipos===
{| style="text-align:left;"
{| style="text-align:left;"
Línea 1665: Línea 1640:


<!----TOTALES-------->
<!----TOTALES-------->
===Totales===
===Totales===
{| style="text-align:left;"
{| style="text-align:left;"
Línea 1778: Línea 1752:


<!----SUBTOTALES-------->
<!----SUBTOTALES-------->
===Subtotales===
===Subtotales===
{| style="text-align:left;"
{| style="text-align:left;"
Línea 1849: Línea 1822:


<!----FONDO DE INCLUSION SOCIAL ENERGETICO-------->
<!----FONDO DE INCLUSION SOCIAL ENERGETICO-------->
===Fondo de Inclusión Social Energético===
===Fondo de Inclusión Social Energético===
{| style="text-align:left;"
{| style="text-align:left;"
Línea 1897: Línea 1869:


<!----PAGO-------->
<!----PAGO-------->
===Pago===
===Pago===
{| style="text-align:left;"
{| style="text-align:left;"
Línea 1959: Línea 1930:


<!----FACTURA GUIA-------->
<!----FACTURA GUIA-------->
===Factura Guía===
===Factura Guía===
{| style="text-align:left;"
{| style="text-align:left;"
Línea 2024: Línea 1994:
'''Nota''': Si se envía información en un campo, todos los demás deben enviarse
'''Nota''': Si se envía información en un campo, todos los demás deben enviarse


<!----FACTURA GUIA - INFORMACIÓN DE PARTIDA-------->
====Factura Guía - Información de Partida====
{| style="text-align:left;"
!Ubicación en Objeto:
! style="color: blue" | tem:Enviar/tem:documentoElectronico/per:facturaGuia/per:FacturaGuia/ per:informacionPartida
|-
!Cantidad de Campos:
!style="text-align:left;"| 2
|-
!Descripción General:
!style="text-align:left;"| 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
|}
{| 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"| <per:direccion>
|<!---Descripción--->    Dirección punto de llegada - Dirección completa y detallada
|<!---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
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:ubigeo>
|<!---Descripción--->    Dirección punto de partida - Código de ubigeo
|<!---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
|-
|}
<!----FACTURA GUIA - INFORMACIÓN DE VEHICULOS-------->
====Factura Guía - Información de Vehículos====
{| style="text-align:left;"
!Ubicación en Objeto:
! style="color: blue" | tem:Enviar/tem:documentoElectronico/per:facturaGuia/per:FacturaGuia/ per:informacionVehiculo
|-
!Cantidad de Campos:
!style="text-align:left;"| 6
|-
!Descripción General:
!style="text-align:left;"| 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
|}
{| 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"| <per:constanciaInscripcion>
|<!---Descripción--->    Número de constancia de inscripción del vehículo o certificado de habilitación vehicular
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...40
|<!---Formato--->        style="text-align:center"| 
|<!---Obligatorio--->    style="text-align:center;"|           
|<!---Opcional--->      style="text-align:center;"|  F
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:documentacionTransportista>
|<!---Descripción--->    Tipo y Número de documento de identidad del transportista o transportista contratante
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...12
|<!---Formato--->        style="text-align:center"|  XXXXXXXX/N donde:<br/>
X: número de identidad <br/>
N: tipo de documento
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:modalidad>
|<!---Descripción--->    Modalidad del transporte
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>2
|<!---Formato--->        style="text-align:center"|  Catálogo N° 18
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:placaVehiculo>
|<!---Descripción--->    Información de vehículo principal - Número de placa.
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...8
|<!---Formato--->        style="text-align:center"| 
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:razonSocialTransportista>
|<!---Descripción--->    Apellidos y nombres o razón social del transportista o transportista contratante
|<!---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
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:registroMTC>
|<!---Descripción--->    Número de registro MTC (Ministerio de Transportes y Comunicaciones)
|<!---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
|-
|}
Nota: Si se envía información en un campo, todos los demás deben enviarse
<!----FACTURA GUIA - INFORMACIÓN DE LLEGADA-------->
====Factura Guía - Información de Llegada====
{| style="text-align:left;"
!Ubicación en Objeto:
! style="color: blue" | tem:Enviar/tem:documentoElectronico/per:facturaGuia/per:FacturaGuia/ per:informacionLlegada
|-
!Cantidad de Campos:
!style="text-align:left;"| 6
|-
!Descripción General:
!style="text-align:left;"| 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
|}
{| 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"| <per:departamento>
|<!---Descripción--->    Dirección punto de llegada - Departamento
|<!---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
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:direccion>
|<!---Descripción--->    Dirección punto de llegada - Dirección completa y detallada
|<!---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
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:distrito>
|<!---Descripción--->    Dirección punto de llegada - Distrito
|<!---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
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:provincia>
|<!---Descripción--->    Dirección punto de llegada - Provincia
|<!---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
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:ubigeo>
|<!---Descripción--->    Dirección punto de llegada - Código de ubigeo
|<!---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
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:urbanizacion>
|<!---Descripción--->    Dirección punto de llegada - Urbanización
|<!---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
|-
|}
Nota: Si se envía información en un campo, todos los demás deben enviarse
<!----LINEAS ADICIONALES - LEYENDAS-------->
===Líneas Adicionales - Leyendas===
{| style="text-align:left;"
!Ubicación en Objeto:
! style="color: blue" | tem:Enviar/tem:documentoElectronico/per:lineasAdicionales/per:LineasAdicionales
|-
!Cantidad de Campos:
!style="text-align:left;"| 2
|-
!Descripción General:
!style="text-align:left;"| 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
|}
{| 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"| <per:codigo>
|<!---Descripción--->    Código a usar para la leyenda
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>4
|<!---Formato--->        style="text-align:center"|  Catálogo N° 52
|<!---Obligatorio--->    style="text-align:center;"|           
|<!---Opcional--->      style="text-align:center;"|  F, B, NC, ND
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:valor>
|<!---Descripción--->    Leyenda a enviar como información adicional
|<!---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, NC, ND
|-
|}




Revisión del 20:31 25 may 2021

Proceso

Como requerimiento inicial, es necesario a través de la integración directa, rellenar el objeto del método Enviar con los datos del comprobante de pago a emitir, para luego -si la respuesta es satisfactoria-, descargar y obtener los archivos PDF, XML y CDR del comprobante emitido; caso contrario, recibir el código de error correspondiente.

Proceso del Modelo Online

Consideraciones

  • El Analista de Integraciones asignado a su cuenta le enviará las credenciales de acceso del ambiente de Pruebas en un correo de bienvenida. Si olvidó o desea restaurar sus credenciales de acceso al servicio, puede restablecerlas desde el Portal de Emisión, en la sección Catálogos-->Cajas Registradoras-->Obtener usuario de integración. Haga clic y el sistema habilitará una ventana, en la cual deberá ingresar un correo electrónico válido, al que se enviarán el usuario y contraseña que usará para Integraciones
  • Su desarrollo deberá incluir el manejo de funciones asíncronas, manejo de excepciones así como las validaciones pertinentes a cada campo de datos, atendiendo a las longitudes, tipos y formatos de cada uno
  • Los catálogos de validaciones de SUNAT se encuentran disponibles para su descarga pública, en el portal del ente tributario CPE SUNAT
  • El manejo del envío de documentos de venta (facturas, boletas, notas asociadas) se realiza por medio de un objeto; esto implica el llenado directamente sobre el request del método Enviar.
  • El manejo del envío de las guías de remisión electrónicas se realiza también mediante un objeto, llenando directamente sobre el request del método GuiaRemision
  • La emisión de Comprobantes de Retención, Comprobantes de Percepción, se realizará el envío de un archivo TXT codificado en base64, según los anexos descritos disponibles en esta wiki
  • Para el consumo de los métodos, los nodos aparecen publicados en forma alfabética

Paso a Paso

Enviar un documento electrónico

  • Rellenar objeto de los métodos Enviar o GuiaRemision

Para enviar un documento de venta, es necesario que su sistema de facturación consuma el servicio web de The Factory HKA, para lo cual deberá invocar al método Enviar y llenar los campos correspondientes a los datos de cada documento de venta a emitir, con el fin de generar los archivos XML con la firma digital y realizar la transmisión hacia OSE/SUNAT, con el fin de obtener su validación y aprobación. Para el caso de las Guías de Remisión Electrónicas, deberá hacer el mismo procedimiento, invocando el método GuiaRemision

  • Generar un archivo TXT para el método RetencionPercepcion

Para enviar un comprobante (de retención o percepción) es necesario que su sistema envía un archivo TXT con un layout específico (y posteriormente codificado en base64), descrito en el artículo Layout de Comprobantes de Retención/Percepción

Conexión para la emisión

Según sea el caso, se debe invocar el método Enviar, RetencionPercepcion o GuiaRemision, todos disponibles en el servicio web de The Factory HKA. Al método se deben enviar los datos correspondientes al documento generado en el paso 1 en el caso de enviar un comprobante de retención/Percepción; o llenar el objeto del request para documentos de venta o guías de remisión. Estos métodos abren el canal de comunicación hacia el servicio de The Factory HKA, quien, a su vez, encapsula toda la lógica del proceso y hace posible la generación del documento electrónico firmado en formato XML, así como la transmisión a OSE/SUNAT. Finalmente, la respuesta especificará el proceso de validación por parte de The Factory HKA, a través de un código de éxito o error, devolviendo igualmente el UUID del documento (Universally Unique IDentifier / tipo-serie-correlativo). Documentos incluidos en el método Enviar:

  • Factura
  • Boleta de venta
  • Nota de crédito
  • Nota de débito

Documentos incluidos en el método RetencionPercepcion:

  • Comprobante de Retención
  • Comprobante de Percepción

Documentos incluidos en el método GuiaRemision:

  • Guía de Remisión

Conexión para descarga de documentos

Si la respuesta de validación fue exitosa, su sistema de facturación puede obtener y mostrar los documentos emitidos en formato PDF y XML, a través del método DescargaArchivo. De igual forma, se puede utilizar el mismo método para descargar el CDR, que le permitirá obtener la respuesta que emite OSE/SUNAT con el estatus de aprobación del documento.

Conexión para Comunicación de Baja y Reversión

En caso de que necesite anular un determinado documento emitido, puede invocar el servicio web de The Factory HKA para comunicar la baja o revertir el documento observado, a través de los métodos ComunicacionBaja y Reversión. Es importante tener en cuenta que el plazo para realizar la comunicación de baja es de 7 días calendario y para realizarla es requisito que los documentos hayan sido aceptados por OSE/SUNAT.

Comprantes incluidos para el método ComunicacionBaja:

  • Factura
  • Boleta de venta
  • Nota de crédito
  • Nota de débito

Comprobantes incluidos para el método Reversión:

  • Retención
  • Percepción

NOTA: No existe la anulación de una Guía de Remisión Electrónica emitida desde los SEE- Del Contribuyente. En este caso, deberá realizar una nueva guía de remisión y relacionar la anterior.

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

Métodos del servicio web de The Factory HKA

Se han implementado diferentes métodos que le permitirán realizar el proceso de facturación electrónica de manera rápida y eficaz. En la especificación de cada uno de ellos se indica la funcionalidad del método, el parámetro que se debe ingresar, y la estructura y ejemplos de las respuestas que puede obtener al ejecutar estos métodos.
El enlace de acceso a nuestro ambiente de pruebas es https://demoint.thefactoryhka.com.pe/Service.svc.

Método Enviar

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 aceptación | Mensaje de aceptación | Serie - correlativo del documento y XML timbrado

Credenciales

Ubicación en Objeto: tem:Enviar/
Cantidad de Campos: 3
Descripción General: Contiene los datos de acceso para validar la identidad del usuario a enviar la información del documento
Recurrencia de la línea: 1
Campo Descripción Tipo|Longitud
<tem:ruc> RUC del emisor N|11
<tem:usuario> Usuario de Integración Emitido por el Sistema
<tem:clave> Contraseña de Integración Emitido por el Sistema

Emisor

Ubicación en Objeto: tem:Enviar/tem:documentoElectronico/per:emisor/
Cantidad de Campos: 4
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
<per:domicilioFiscal> Dirección del domicilio fiscal AN|...100 F, B, NC, ND
<per:lugarExpedicion> Código asignado por SUNAT para el establecimiento anexo declarado en el RUC N|4 F, B, NC, ND
<per:ruc> RUC del emisor N|11 F, B, NC, ND
<per: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


Receptor

Ubicación en Objeto: tem:Enviar/tem:documentoElectronico/per:receptor
Cantidad de Campos: 12
Descripción General: Contiene información del cliente
Recurrencia de la línea: 0...1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
<per:departamento> Departamento de la dirección del cliente AN|...100 F, B, NC, ND
<per:direccion> Dirección del cliente AN|...100 F, B, NC, ND
<per:distrito> Distrito de la dirección del cliente AN|...100 F, B, NC, ND
<per:email> Email del cliente. Debe ser una dirección válida para el envío correcto del documento electrónico AN|...100 F, B, NC, ND
<per:notificar> Flag de notificación para envío de correo electrónico AN|2 SI para notificar

NO en caso contrario

F, B, NC, ND
<per:numDocumento> Número de documento del cliente AN|...13 F, NC, ND B*
<per:pais> País al que hace referencia la dirección AN|...100 F, B, NC, ND
<per:provincia> Provincia de la dirección del cliente AN|...100 F, B, NC, ND
<per:razonSocial> Nombres y Apellidos o Razón social del cliente AN|...100 F, NC, ND B*
<per:telefono> Teléfono del cliente AN|...50 F, B, NC, ND
<per:tipoDocumento> Tipo de documento del cliente AN|...13 Catálogo N° 06 F, NC, ND B*
<per:ubigeo> Ubigeo de la dirección del cliente N|6 Catálogo N° 13 F, B, NC, ND

* : En el caso de Boletas, debe viajar esta información de forma obligatoria cuando el monto total supera los S/ 700.

Delivery (Entrega de bien o servicio)

Ubicación en Objeto: tem:Enviar/tem:documentoElectronico/per:entregaBienoServicio
Cantidad de Campos: 8
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
<per:codigoPais> Código de país de la dirección para la entrega AN|2 Catálogo N° 04 F, B
<per:departamento> Departamento de la dirección para la entrega AN|...30 F, B
<per:direccion> Dirección para la entrega AN|...200 F, B
<per:distrito> Distrito de la dirección para la entrega AN|...30 F, B
<per:paisUsoServicio> País de uso del servicio o bien entregado AN|2 Catálogo N° 04 F, B
<per:provincia> Provincia de la dirección para la entrega AN|...30 F, B
<per:ubigeo> Ubigeo de la dirección para la entrega AN|6 Catálogo N° 13 F, B
<per:urbanizacion> Urbanización de la dirección para la entrega AN|...25 F, B

Comprobante

Ubicación en Objeto: tem:Enviar/
Cantidad de Campos: 8
Descripción General: Contiene información del comprobante electrónico
NOTA: Los nodos son hijos directos del nodo tem:Enviar/
Recurrencia de la línea: 1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
<per:codigoTipoOperacion> Código de tipo de operación AN|2 Catálogo N° 51 F, B, NC, ND
<per:correlativo> Correlativo del documento N|...8 F, B, NC, ND
<per:fechaEmision> Fecha de emisión del documento en curso AN|10 YYYY-MM-DD F, B, NC, ND
<per:fechaVencimiento> Fecha de vencimiento del documento AN|10 YYYY-MM-DD F, B
<per:horaEmision> Hora de emisión del documento en curso AN|8 hh:mm:ss F, B, NC, ND
<per: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
<per: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
<per:tipoDocumento> Tipo de documento en curso AN|2 Catálogo N° 01 F, B, NC, ND

Datos de Comprobante Relacionado

Datos de Comprobante relacionado – Información relacionada a Facturas

Ubicación en Objeto: tem:Enviar/tem:documentoElectronico/per:relacionado/per:Relacionado
Cantidad de Campos: 5
Descripción General: Contiene información de los documentos relacionados con el documento en curso
Recurrencia de la línea: 0...1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
<per:numeroDocRelacionado> Serie y número del documento relacionado con la operación que se factura AN|...30 ZZZZ-NNNNNNNN, donde:

ZZZZ corresponde a la serie
NNNNNNNN al número de documento

F
<per:numeroGRRelacionada> Número de la guía de remisión relacionada con la operación que se factura AN|...30 ZZZZ-NNNNNNNN, donde:

ZZZZ corresponde a la serie
NNNNNNNN al número de documento

F, B, NC
<per:numeroOrdenCompra> Número de la orden de compra AN|...20 Sin espacios, sin guiones, sin salto de línea F, B, NC
<per:tipoDocRelacionado> Tipo del documento relacionado con la operación que se factura N|2 Catálogo N° 01 F
<per:tipoGRRelacionada> Tipo de la guía de remisión relacionada con la operación que se factura N|2 Catálogo N° 01 F, B, NC

Datos de Comprobante relacionado – Información relacionada a Notas de Crédito y Débito

Ubicación en Objeto: tem:Enviar/tem:documentoElectronico/per:relacionadoNotas
Cantidad de Campos: 4
Descripción General: Contiene información de los documentos afectados con la nota de crédito/débito en curso
Recurrencia de la línea: 0...1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
<per:codigoTipoNota> Código de tipo de nota de crédito o débito AN|2 Catálogo N° 09 (Nota de Crédito)

Catálogo N° 10 (Nota de Débito)

NC, ND
<per:numeroDocAfectado> Serie y número del comprobante que se modifica AN|...13 ZZZZ-NNNNNNNN, donde:

ZZZZ corresponde a la serie
NNNNNNNN al número de documento

NC, ND
<per:observaciones> Motivo de emisión de la nota de crédito o débito AN|...250 Sin espacios, sin guiones, sin salto de línea NC, ND
<per:tipoDocAfectado> Tipo de comprobante que se modifica N|2 Catálogo N° 01 NC, ND

Producto

Ubicación en Objeto: tem:Enviar/tem:documentoElectronico/per:producto/per:Producto
Cantidad de Campos: 14
Descripción General: Contiene información base del producto, de forma individual
Recurrencia de la línea: 1...n
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
<per:cantidad> Cantidad de unidades del ítem N|(12,10) F, B, NC, ND
<per:codigoGS1> Sistema de codificación estándar que identifica de manera única y no ambigua cada referencia. Si no se cuenta con el código SUNAT, puede usarse éste AN|...14 F, B, NC, ND
<per:codigoPLU> Código de producto del ítem, interno y de uso del establecimiento AN|...30 No debe tener saltos de línea F, B, NC, ND
<per:codigoPLUSunat> Código de producto (SUNAT), basado en el estándar internacional de la ONU (UNSPSC: United Nations Standard Products and Services Code) N|...8 Catálogo N° 25 * F, B, NC, ND
<per:descripcion> Descripción detallada del servicio prestado, bien vendido o cedido en uso, indicando las características AN|...250 F, B, NC, ND
<detalleProducto> Informacion adicional para el producto AN|...250 F, B, NC, ND
<per:montoTotalImpuestoItem> Monto total de impuestos por línea N|(12,2) F, B, NC, ND
<per:numeroOrden> Número de orden del ítem N|3 Ordinal correlativo. no debe superar el número de ítems reportados F, B, NC, ND
<per:numeroPlacaVehiculo> Información Adicional - Gastos art.37° Renta AN|...100 F
<per:precioVentaUnitarioItem> Precio de venta unitario. Contiene impuestos N|(12,10) F, B, NC, ND
<per:unidadMedida> Código de unidad de medida del ítem AN|3 Catálogo N° 03 F, B, NC, ND
<per:valorReferencialUnitario> Valor referencial unitario en operaciones no onerosas, para identificar este tipo de operaciones (gratuitas, por ejemplo) N|(12,10) ** F, B, NC, ND
<per:valorUnitarioBI> Valor de venta del ítem, no incluye los impuestos (base imponible) N|(12,10) F, B, NC, ND
<per:valorVentaItemQxBI> Valor de venta del ítem (cantidad x base imponible) N|(12,10) F, B, NC, ND

*: Este valor deberá ser obligatorio para las facturas de exportación
**: Se enviará este campo cuando el producto esté involucrado en una operación no onerosa

Producto - IGV sobre ítem

Ubicación en Objeto: tem:Enviar/tem:documentoElectronico/per:producto/per:Producto/per:IGV/per:ProductoIGV
Cantidad de Campos: 4
Descripción General: Contiene información del IGV que afecta al producto
Recurrencia de la línea: 1...n
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
<per:baseImponible> Monto de la operación, base imponible sobre la que se calculará el impuesto N|(12,2) F, B, NC, ND
<per:monto> Monto de tributo del ítem N|(12,2) F, B, NC, ND
<per:porcentaje> Porcentaje del impuesto IGV N|(3,5) F, B, NC, ND
<per:tipo> Código de tipo de afectación del IGV AN|2 Catálogo N° 07 F, B, NC, ND

Producto - IVAP sobre ítem

Ubicación en Objeto: tem:Enviar/tem:documentoElectronico/per:producto/per:Producto/per:IVAP/per:ProductoIVAP
Cantidad de Campos: 4
Descripción General: Contiene información del IVAP que afecta al producto
Recurrencia de la línea: 0...n
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
<per:baseImponible> Monto de la operación, base imponible sobre la que se calculará el impuesto N|(12,2) F, B, NC, ND
<per:monto> Monto de tributo del ítem N|(12,2) F, B, NC, ND
<per:porcentaje> Porcentaje del impuesto IVAP N|(3,5) F, B, NC, ND
<per:tipo> Código de tipo de afectación del IVAP AN|2 Catálogo N° 07 F, B, NC, ND

Producto - ISC sobre ítem

Ubicación en Objeto: tem:Enviar/tem:documentoElectronico/per:producto/per:Producto/per:ISC/per:ProductoISC
Cantidad de Campos: 4
Descripción General: Contiene información del ISC que afecta al producto
Recurrencia de la línea: 0...n
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
<per:baseImponible> Monto de la operación, base imponible sobre la que se calculará el impuesto N|(12,2) F, B, NC, ND
<per:monto> Monto de tributo del ítem N|(12,2) F, B, NC, ND
<per:porcentaje> Porcentaje del impuesto ISC N|(3,5) F, B, NC, ND
<per:tipo> Código de tipo de afectación del ISC AN|2 Catálogo N° 08 F, B, NC, ND

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

Producto - Otros Tributos sobre ítem - ICBPER

Ubicación en Objeto: tem:Enviar/tem:documentoElectronico/per:producto/per:Producto/ per:otrosTributos/per:ProductoOtrosTributos
Cantidad de Campos: 4
Descripción General: : Contiene información de otros impuestos que afectan al producto
Recurrencia de la línea: 0...n
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
<per:baseImponible> Monto de la operación, base imponible sobre la que se calculará el impuesto

Cantidad de bolsas de plástico

N|(12,2) F, B, NC, ND
<per:monto> Monto de tributo del ítem

Cantidad de bolsas multiplicado por el valor unitario de la misma

N|(12,2) F, B, NC, ND
<per:porcentaje> Tasa de porcentaje de otros impuestos

Valor unitario de la bolsa de plástico

N|(3,5) F, B, NC, ND
<per:tipo> Código de tipo de afectación de otros impuestos N|4 Catálogo N° 05 F, B, NC, ND

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

Producto - Descuentos sobre ítem

Ubicación en Objeto: tem:Enviar/tem:documentoElectronico/per:producto/per:Producto/per:descuento/per:ProductoDescuento
Cantidad de Campos: 4
Descripción General: : Contiene información del descuento que afecta al producto
Recurrencia de la línea: 0...1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
<per:baseImponible> Monto de la operación, base imponible sobre la que se calculará el descuento N|(12,2) F, B, NC, ND
<per:monto> Monto de descuento a aplicar sobre el ítem N|(12,2) F, B, NC, ND
<per:porcentaje> Tasa de porcentaje del descuento a aplicar sobre el ítem N|(3,5) F, B, NC, ND
<per:codigo> Código de tipo de descuento a aplicar AN|2 Catálogo N° 53 F, B, NC, ND

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

Producto - Cargos sobre ítem

Ubicación en Objeto: tem:Enviar/tem:documentoElectronico/per:producto/per:Producto/per:cargo/per:ProductoCargo
Cantidad de Campos: 4
Descripción General: : Contiene información del cargo que afecta al producto
Recurrencia de la línea: 0...1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
<per:baseImponible> Monto de base del cargo del ítem, base imponible sobre la que se calculará el cargo N|(12,2) F, B, NC, ND
<per:monto> Monto de cargo a aplicar sobre el ítem N|(12,2) F, B, NC, ND
<per:porcentaje> Tasa de porcentaje del cargo a aplicar sobre el ítem N|(3,5) F, B, NC, ND
<per:codigo> Código de tipo de descuento a aplicar AN|2 Catálogo N° 53 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: tem:Enviar/tem:documentoElectronico/per: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
<per:baseImponible> Monto de base imponible de descuento global N|(12,2) F, B, NC, ND
<per:monto> Monto total del descuento global. Forma parte de los totales del documento N|(12,2) F, B, NC, ND
<per:motivo> Código del motivo del descuento AN|...2 Catálogo N° 53 F, B, NC, ND
<per: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

Cargos Globales

Ubicación en Objeto: tem:Enviar/tem:documentoElectronico/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
<per:baseImponible> Monto de base imponible de cargo global N|(12,2) F, B, NC, ND
<per:monto> Monto total del cargo global. Forma parte de los totales del documento N|(12,2) F, B, NC, ND
<per:motivo> Código del motivo del cargo AN|...2 Catálogo N° 53 F, B, NC, ND
<per: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

Percepciones

Ubicación en Objeto: tem:Enviar/tem:documentoElectronico/per:percepción
Cantidad de Campos: 4
Descripción General: : Contiene información del pago que acredita la percepción
Recurrencia de la línea: 0...1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
<per:baseImponible> Base imponible sobre la que será calculada la percepción N|(12,2) F
<per:codigo> Código de tipo de monto de la percepción (motivo) N|2 Catálogo N° 53 F
<per:monto> Monto total de la percepción N|(12,2) F
<per:porcentaje> Factor de la percepción N|(12,2) F

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

Detracciones

Ubicación en Objeto: tem:Enviar/tem:documentoElectronico/per:detracción/per: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
<per:codigo> Código del bien o producto sujeto a detracción N|2 Catálogo N° 54 F, B
<per:medioPago> Medio de pago de la detracción AN|3 Catálogo N° 59 F, B
<per:monto> Monto de la detracción N|(12,2) F, B
<per:numCuentaBancodelaNacion> Número Cuenta del Banco de la Nación AN|...100 F, B
<per: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: tem:Enviar/tem:documentoElectronico/per:detracción/per:Detraccion/ per:recursosHidrobiologicos/per: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
<per:cantidadEspecie> Cantidad de la especie vendida AN|...15 F, B
<per:codigo> Código de identificación del concepto tributario AN|4 Catálogo N° 55 F, B
<per:descripcionEspecie> Descripción del tipo de la especie vendida AN|...100 F, B
<per:fechaDescarga> Fecha de descarga de la especie AN|10 YYYY-MM-DD F, B
<per:lugarDescarga> Lugar de descarga de la especie AN|...200 F, B
<per:matricula> Matrícula de la embarcación pesquera AN|...15 F, B
<per:nombre> Nombre de la embarcación pesquera AN|...50 F, B
<per: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: tem:Enviar/tem:documentoElectronico/per:detracción/per:Detraccion/ per: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
<per:detalledelViaje> Información detallada del viaje AN|...500 F, B
<per:direccionDestino> Dirección detallada del destino AN|...200 F, B
<per:direccionOrigen> Dirección detallada del origen AN|...200 F, B
<per:referenciaCargaEfectiva> Valor referencial sobre la carga efectiva N|(12,2) F, B
<per:referenciaCargaNominal> Valor referencial sobre la carga útil nominal N|(12,2) F, B
<per:referenciaServicio> Valor referencial del servicio de transporte N|(12,2) F, B
<per:ubigeoDestino> Código de UBIGEO de destino AN|6 Catálogo N° 13 F, B
<per: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: tem:Enviar/tem:documentoElectronico/per:detracción/per:Detraccion/ per:servicioTransporteCarga/per:detalleTramos/per:DetalleTramos
Cantidad de Campos: 4
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
<per:descripcion> Descripción del tramo recorrido AN|...100 F, B
<per:puntoDestino> Punto de destino del viaje (código UBIGEO de destino) AN|6 Catálogo N° 13 F, B
<per:puntoOrigen> Punto de origen del viaje (código UBIGEO de origen) AN|6 Catálogo N° 13 F, B
<per: 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: tem:Enviar/tem:documentoElectronico/per:detracción/per:Detraccion/ per:servicioTransporteCarga/per:detalleVehiculo/per: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
<per:cargaEfectiva> Valor de la carga efectiva en TM del vehículo N|(12,2) F, B
<per:cargaUtil> Valor de la Carga útil en TM del vehículo N|(12,2) F, B
<per:configuracionVehicular> Configuración vehicular del vehículo AN|...15 Según Códigos del D.S. 058-2003-MTC y modificatorias F, B
<per factordeRetorno> Indicador de factor de retorno de viaje AN|2 SI: para indicar retorno

NO: caso contrario

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

NO: caso contrario

F, B

Anticipos

Ubicación en Objeto: tem:Enviar/tem:documentoElectronico/per:anticipo
Cantidad de Campos: 7
Descripción General: : Contiene información del pago que acredita la percepción
Recurrencia de la línea: 0...n
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
<per:codigoTipoMoneda> Código de tipo de moneda del monto del anticipo AN|3 Catálogo N° 02 F, B
<per:fecha> Fecha del pago AN|10 YYYY-MM-DD F, B
<per:identificador> Identificador del pago N|2 Ordinal del pago (01, 02...etc.) F, B
<per:montoPrepagado> Monto prepagado o anticipado N|(15,2) F, B
<per: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
<per:rucEmisorComprobante> Número de RUC del emisor del comprobante de anticipo AN|11 F, B
<per: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

Totales

Ubicación en Objeto: tem:Enviar/tem:documentoElectronico/per:totales
Cantidad de Campos: 12
Descripción General: : Contiene los totales del documento
Recurrencia de la línea: 1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
<per:importeTotalPagar> Importe total de la venta. Equivale al Importe total de la venta – Total de Descuentos +

Sumatoria de otros cargos - anticipos

N|(12,2) F, B, NC, ND
<per:importeTotalVenta> Total precio de venta (Incluye impuestos) N|(12,2) F, B, NC, ND
<per:montoRedondeo> Monto para redondeo del importe total. Si el total a pagar es 99.99 y se redondea a 100.00,

este campo debe contener la diferencia entre el monto redondeado menos el monto real (es decir, 0.01)

N|(12,2) Ordinal del pago (01, 02...etc.) F, B, NC, ND
<per:montoTotalAnticipos> Monto total de anticipos del comprobante N|(12,2) F, B, NC, ND
<per:montoTotalImpuestos> Monto total de impuestos N|(12,2) F, B, NC, ND
<per:subtotalValorVenta> Subtotal del documento N|(12,2) F, B, NC, ND
<per:sumaTotalDescuentosporItem> Monto total de descuentos del comprobante N|(12,2) F, B, NC, ND
<per:sumatoriaImpuestosOG> Sumatoria de impuestos - Operaciones gratuitas N|(12,2) F, B, NC, ND
<per:totalIGV> Monto total del IGV N|(12,2) F, B, NC, ND
<per:totalISC> Monto total del ISC N|(12,2) F, B, NC, ND
<per:totalIVAP> Monto total del IVAP N|(12,2) F, B, NC, ND
<per:totalOtrostributos> Monto total de Otros tributos N|(12,2) F, B, NC, ND

Subtotales

Ubicación en Objeto: tem:Enviar/tem:documentoElectronico/per:totales/per:subtotal
Cantidad de Campos: 6
Descripción General: Contiene información detallada de los subtotales del documento, discriminando las porciones de montos de ventas sujetas a los distintos tipos de tributos que sumados,

generan el total contenido en el nodo <per:subtotalValorVenta> en el campo Total valor de la venta (Subtotal)

Recurrencia de la línea: 1
Campo Descripción Tipo|Longitud Formato Obligatorio Opcional
<per:IGV> Monto de las operaciones gravadas por el impuesto IGV N|(12,2) * F, B, NC, ND
<per:IVAP> Monto de las operaciones gravadas por el impuesto IVAP N|(12,2) * F, B, NC, ND
<per:exoneradas> Monto de las operaciones exoneradas de IGV N|(12,2) * F, B, NC, ND
<per:exportacion> Monto de las ventas de exportación N|(12,2) * F, B, NC, ND
<per:gratuitas> Monto de las ventas gratuitas N|(12,2) * F, B, NC, ND
<per:inafecta> Monto de las operaciones inafectas de IGV N|(12,2) * F, B, NC, ND

*: Implica que es mandatorio si aparece en el campo Totales algún valor relacionado. No condiciona la aparición de otros campos

Fondo de Inclusión Social Energético

Ubicación en Objeto: tem:Enviar/tem:documentoElectronico/per:fondoIncSocEnergetico/ per: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
<per:Motivo> Código tipo de monto AN|2 Catálogo N° 53 F, B
<per:baseImponible> Base imponible para la percepción N|(12,2) F, B
<per:monto> Monto del cargo/descuento por FISE N|(12,2) F, B

Pago

Ubicación en Objeto: tem:Enviar/tem:documentoElectronico/per: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
<per:fechaFin> Fecha de fin de ciclo de facturación AN|10 YYYY-MM-DD F, B, NC, ND
<per:fechaInicio> Fecha de inicio de ciclo de facturación AN|10 YYYY-MM-DD F, B, NC, ND
<per:metodoPago> Medio de pago utilizado en el documento N|3 Catálogo N° 59 F, B, NC, ND
<per: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
<per: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

Factura Guía

Ubicación en Objeto: tem:Enviar/tem:documentoElectronico/per:facturaGuia/per: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
<per:cantidadVehiculos> Información de vehículos secundarios AN|...8 F
<per:fechaInicio> Fecha de inicio del traslado o fecha de entrega de bienes al transportista AN|10 YYYY-MM-DD F
<per:motivoTraslado> Código de motivo de traslado AN|2 Catálogo N° 20 F
<per: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
<per: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: tem:Enviar/tem:documentoElectronico/per:facturaGuia/per:FacturaGuia/ per: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
<per:direccion> Dirección punto de llegada - Dirección completa y detallada AN|...200 F
<per: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: tem:Enviar/tem:documentoElectronico/per:facturaGuia/per:FacturaGuia/ per: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
<per:constanciaInscripcion> Número de constancia de inscripción del vehículo o certificado de habilitación vehicular AN|...40 F
<per: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
<per:modalidad> Modalidad del transporte AN|2 Catálogo N° 18 F
<per:placaVehiculo> Información de vehículo principal - Número de placa. AN|...8 F
<per:razonSocialTransportista> Apellidos y nombres o razón social del transportista o transportista contratante AN|...200 F
<per: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: tem:Enviar/tem:documentoElectronico/per:facturaGuia/per:FacturaGuia/ per: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
<per:departamento> Dirección punto de llegada - Departamento AN|...200 F
<per:direccion> Dirección punto de llegada - Dirección completa y detallada AN|...200 F
<per:distrito> Dirección punto de llegada - Distrito AN|...200 F
<per:provincia> Dirección punto de llegada - Provincia AN|...200 F
<per:ubigeo> Dirección punto de llegada - Código de ubigeo AN|6 Catálogo N° 13 F
<per: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

Líneas Adicionales - Leyendas

Ubicación en Objeto: tem:Enviar/tem:documentoElectronico/per:lineasAdicionales/per: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
<per:codigo> Código a usar para la leyenda AN|4 Catálogo N° 52 F, B, NC, ND
<per:valor> Leyenda a enviar como información adicional AN|...100 F, B, NC, ND


Método

Método

Método

Obtenido de «http://felwiki.thefactoryhka.com.pe/index.php?title=Integración_Directa_-_Web_Service_SOAP&oldid=149»