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
 
(No se muestran 47 ediciones intermedias de 4 usuarios)
Línea 52: Línea 52:
'''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.
'''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==
==Métodos del servicio web de The Factory HKA==
===Tipo de Longitud ===
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/>
'''A''': Carácter alfabético <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].
'''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


==Métodos del servicio web de The Factory HKA==
===Enviar===
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.
----''Artículo principal:'' [[Web_Service_SOAP_-_Método_Enviar|Web Service SOAP - Método Enviar]]


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


==Método Enviar==
{| class="wikitable" style="margin: auto;"
{| class="wikitable" style="margin: auto;"
! style="text-align:left;"  style="color:red"| Descripción
! style="text-align:left;"  style="color:red"| Descripción
Línea 94: Línea 73:
|}
|}


<!----CREDENCIALES---->
===CargarCertificado===
----
{| class="wikitable" style="margin: auto;"
! style="text-align:left;"  style="color:red"| Descripción
! ''Método de carga de certificado electrónico en la cuenta del usuario que se usará para firmar electrónicamente los documentos y comprobantes a consignar para OSE/SUNAT.''
|-
! style="text-align:left;"  style="color:red"| Respuesta Exitosa
! ''Código, Mensaje''
|}


===Credenciales===
{| style="text-align:left;"
{| style="text-align:left;"
!Ubicación en Objeto:
!Nombre del método
! style="color: blue" | tem:Enviar/
! style="color: blue" | CargarCertificado
|-
|-
!Cantidad de Campos:
!Cantidad de Campos:
!style="text-align:left;"|3
!style="text-align:left;"|5
|-
!Descripción General:
!style="text-align:left;"|Contiene los datos de acceso para validar la identidad del usuario a enviar la información del documento
|-
!Recurrencia de la línea:
! 1
|}
|}


Línea 127: Línea 107:
|<!---Descripción--->    Contraseña de Integración Emitido por el Sistema
|<!---Descripción--->    Contraseña de Integración Emitido por el Sistema
|<!---Tipo|Longitud--->  style="text-align:center;"|
|<!---Tipo|Longitud--->  style="text-align:center;"|
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:certificadoBase64>
|<!---Descripción--->    Certificado autorizado, cifrado en base 64
|<!---Tipo|Longitud--->  style="text-align:center;"|
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:certificadoClaveBase64>
|<!---Descripción--->    Clave del certificado, cifrada en base 64
|<!---Tipo|Longitud--->  style="text-align:center;"|
|-
|}
|}


<!----EMISOR---->
===ComunicacionBaja===
----
{| class="wikitable" style="margin: auto;"
! style="text-align:left;"  style="color:red"| Descripción
! ''Método para dar de baja a los documentos de venta (factura, boleta de venta, nota de crédito y nota de débito) enviados al OSE/SUNAT''
|-
! style="text-align:left;"  style="color:red"| Respuesta Exitosa
! ''Código, Mensaje''
|}


===Emisor===
{| style="text-align:left;"
{| style="text-align:left;"
!Ubicación en Objeto:
!Nombre del método
! style="color: blue" | tem:Enviar/tem:documentoElectronico/per:emisor/
! style="color: blue" | ComunicacionBaja
|-
|-
!Cantidad de Campos:
!Cantidad de Campos:
!style="text-align:left;"|4
!style="text-align:left;"|5
|-
!Descripción General:
!style="text-align:left;"|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
|}
|}


{| class="wikitable" style="margin: auto;"
{| class="wikitable" style="margin: auto;"
!Campo                                   <!----Encabezado de Tabla---->
!Campo
!Descripción
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Tipo<nowiki>|</nowiki>Longitud
!Formato
!Formato
!Obligatorio
!Opcional                                <!----Encabezado de Tabla FIN---->
|-
|-
|<!---Campo--->         style="color: blue; text-align:center"| <per:domicilioFiscal>
|<!---Campo--->           style="color: blue; text-align:center"| <tem:ruc>
|<!---Descripción--->   Dirección del domicilio fiscal                         
|<!---Descripción--->     RUC del emisor
|<!---Tipo|Longitud---> style="text-align:center;"| AN<nowiki>|</nowiki>...100
|<!---Tipo|Longitud--->   style="text-align:center;"| N<nowiki>|</nowiki>11
|<!---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" | <tem:usuario>
|<!---Descripción--->    Usuario de Integración Emitido por el Sistema
|<!---Tipo|Longitud--->   style="text-align:center;"|
|
|-
|<!---Campo--->           style="color: blue; text-align:center" | <tem:clave>
|<!---Descripción--->    Contraseña de Integración Emitido por el Sistema
|<!---Tipo|Longitud--->  style="text-align:center;"|
|-
|-
|<!---Campo--->         style="color: blue; text-align:center"| <per:lugarExpedicion>
|<!---Campo--->           style="color: blue; text-align:center" | <tem:documento>
|<!---Descripción--->   Código asignado por SUNAT para el establecimiento anexo declarado en el RUC                         
|<!---Descripción--->     Tipo, serie y correlativo de documento a dar de baja
|<!---Tipo|Longitud---> style="text-align:center;"| N<nowiki>|</nowiki>4
|<!---Tipo|Longitud--->   style="text-align:center;"| AN<nowiki>|</nowiki>...16
|<!---Formato--->       style="text-align:center"|  
|<!---Formato--->         style="text-align:center;"| TT-XZZZ-NNNNNNNN <br/>
|<!---Obligatorio--->   style="text-align:center;"| F, B, NC, ND               
  Donde TT hace referencia al tipo de documento según catálogo N° 01 <br/>
|<!---Opcional--->       style="text-align:center;"|
  X hace referencia al tipo de documento: <br/>
  F: Factura o notas asociadas <br/>
  B: Boletas o notas asociadas <br/>
  ZZZ hace referencia a la serie <br/>
  NNNNNNNN hace referencia al correlativo
|-
|-
|<!---Campo--->         style="color: blue; text-align:center"| <per:ruc>  
|<!---Campo--->           style="color: blue; text-align:center" | <tem:motivo>
|<!---Descripción--->   RUC del emisor                         
|<!---Descripción--->     Motivo de la anulación del documento
|<!---Tipo|Longitud---> style="text-align:center;"| N<nowiki>|</nowiki>11
|<!---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   
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:serialCaja>
|<!---Descripción--->    Serial numérico del equipo o aplicación en caso de que el emisor utilice un medio diferente al WS                         
|<!---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, NC, ND   
|}
|}


===DescargaArchivo===
----
{| class="wikitable" style="margin: auto;"
! style="text-align:left;"  style="color:red"| Descripción
! ''Método para descargar los diferentes archivos relacionados con los documentos de venta (PDF, XML, CDR) enviados al OSE/SUNAT''
|-
! style="text-align:left;"  style="color:red"| Respuesta Exitosa
! ''Código, Mensaje''
|}


<!----RECEPTOR---->
===Receptor===
{| style="text-align:left;"
{| style="text-align:left;"
!Ubicación en Objeto:
!Nombre del método
! style="color: blue" | tem:Enviar/tem:documentoElectronico/per:receptor
! style="color: blue" | DescargaArchivo
|-
|-
!Cantidad de Campos:
!Cantidad de Campos:
!style="text-align:left;"|12
!style="text-align:left;"|4
|-
!Descripción General:
!style="text-align:left;"|Contiene información del cliente
|-
!Recurrencia de la línea:
! 0...1
|}
|}


{| class="wikitable" style="margin: auto;"
{| class="wikitable" style="margin: auto;"
!Campo                                   <!----Encabezado de Tabla---->
!Campo
!Descripción
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Tipo<nowiki>|</nowiki>Longitud
!Formato
!Formato
!Obligatorio
!Opcional                                <!----Encabezado de Tabla FIN---->
|-
|-
|<!---Campo--->         style="color: blue; text-align:center"| <per:departamento>
|<!---Campo--->           style="color: blue; text-align:center" | <tem:usuario>
|<!---Descripción--->   Departamento de la dirección del cliente                       
|<!---Descripción--->     Usuario de Integración Emitido por el Sistema
|<!---Tipo|Longitud---> style="text-align:center;"| AN<nowiki>|</nowiki>...100
|<!---Tipo|Longitud--->   style="text-align:center;"|
|<!---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"| <per:direccion>
|<!---Campo--->           style="color: blue; text-align:center" | <tem:clave>
|<!---Descripción--->   Dirección del cliente                         
|<!---Descripción--->     Contraseña de Integración Emitido por el Sistema
|<!---Tipo|Longitud---> style="text-align:center;"| AN<nowiki>|</nowiki>...100
|<!---Tipo|Longitud--->   style="text-align:center;"|
|<!---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"| <per:distrito>
|<!---Campo--->           style="color: blue; text-align:center" | <tem:documento>
|<!---Descripción--->   Distrito de la dirección del cliente                       
|<!---Descripción--->     Tipo, serie y correlativo de documento a dar de baja
|<!---Tipo|Longitud---> style="text-align:center;"| AN<nowiki>|</nowiki>...100
|<!---Tipo|Longitud--->   style="text-align:center;"| AN<nowiki>|</nowiki>...16
|<!---Formato--->       style="text-align:center"|  
|<!---Formato--->         style="text-align:center;"| TT-XZZZ-NNNNNNNN <br/>
|<!---Obligatorio--->   style="text-align:center;"|
  Donde TT hace referencia al tipo de documento según catálogo N° 01 <br/>
|<!---Opcional--->       style="text-align:center;"| F, B, NC, ND   
  X hace referencia al tipo de documento: <br/>
  F: Factura o notas asociadas <br/>
  B: Boletas o notas asociadas <br/>
  ZZZ hace referencia a la serie <br/>
  NNNNNNNN hace referencia al correlativo
|-
|-
|<!---Campo--->         style="color: blue; text-align:center"| <per:email>  
|<!---Campo--->           style="color: blue; text-align:center"| <tem:tipoArchivo>
|<!---Descripción--->   Email del cliente. Debe ser una dirección válida para el envío correcto del documento electrónico                       
|<!---Descripción--->     Tipo de archivo a descargar
|<!---Tipo|Longitud---> style="text-align:center;"| AN<nowiki>|</nowiki>...100
|<!---Tipo|Longitud--->   style="text-align:center;"| AN<nowiki>|</nowiki>3
|<!---Formato--->       style="text-align:center"|  
|<!---Formato--->         style="text-align:center;"| PDF: Para descargar el pdf (representación impresa) <br/>
|<!---Obligatorio--->   style="text-align:center;"|
XML: Para descargar el xml (documento electrónico) <br/>
|<!---Opcional--->       style="text-align:center;"| F, B, NC, ND
CDR: Para descargar la Constancia de Recepción de OSE/SUNAT
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:notificar>
|}
|<!---Descripción--->    Flag de notificación para envío de correo electrónico
 
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>2
===EstatusDocumento===
|<!---Formato--->        style="text-align:center"| '''SI''' para notificar<br/>
----
'''NO''' en caso contrario
{| class="wikitable" style="margin: auto;"
|<!---Obligatorio--->    style="text-align:center;"|
! style="text-align:left;"  style="color:red"| Descripción
|<!---Opcional--->      style="text-align:center;"| F, B, NC, ND  
! ''Método para consultar estatus de documentos (factura, boleta de venta, nota de crédito y nota de débito) en el servicio '''The Factory HKA''', para verificar si ya se envió a OSE/Sunat''
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:numDocumento>
|<!---Descripción--->    Número de documento del cliente
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...13
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"| F, NC, ND
|<!---Opcional--->      style="text-align:center;"| B*
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:pais>
! style="text-align:left;"  style="color:red"| Respuesta Exitosa
|<!---Descripción--->    País al que hace referencia la dirección
! ''Código, Mensaje''
|<!---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
|-  
|<!---Campo--->          style="color: blue; text-align:center"| <per:provincia>
|<!---Descripción--->    Provincia de la dirección del cliente
|<!---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
|- 
|<!---Campo--->          style="color: blue; text-align:center"| <per:razonSocial>
|<!---Descripción--->    Nombres y Apellidos o Razón social del cliente
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...100
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"| F, NC, ND
|<!---Opcional--->      style="text-align:center;"| B*
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:telefono>
|<!---Descripción--->    Teléfono del cliente
|<!---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, NC, ND
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:tipoDocumento>
|<!---Descripción--->    Tipo de documento del cliente
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...13
|<!---Formato--->        style="text-align:center"| Catálogo N° 06
|<!---Obligatorio--->    style="text-align:center;"| F, NC, ND
|<!---Opcional--->      style="text-align:center;"| B*
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:ubigeo>
|<!---Descripción--->    Ubigeo de la dirección del cliente
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>6
|<!---Formato--->        style="text-align:center"| Catálogo N° 13
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B, NC, ND
|}
|}
<nowiki>*</nowiki> : En el caso de Boletas, debe viajar esta información de forma obligatoria cuando el monto total supera los S/ 700.


<!----DELIVERY---->
===Delivery (Entrega de bien o servicio)===
{| style="text-align:left;"
{| style="text-align:left;"
!Ubicación en Objeto:
!Nombre del método
! style="color: blue" | tem:Enviar/tem:documentoElectronico/per:entregaBienoServicio
! style="color: blue" | EstatusDocumento
|-
|-
!Cantidad de Campos:
!Cantidad de Campos:
!style="text-align:left;"|8
!style="text-align:left;"|3
|-
!Descripción General:
!style="text-align:left;"|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
|}
|}


{| class="wikitable" style="margin: auto;"
{| class="wikitable" style="margin: auto;"
!Campo                                   <!----Encabezado de Tabla---->
!Campo
!Descripción
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Tipo<nowiki>|</nowiki>Longitud
!Formato
!Formato
!Obligatorio
!Opcional                                <!----Encabezado de Tabla FIN---->
|-
|-
|<!---Campo--->         style="color: blue; text-align:center"| <per:codigoPais>
|<!---Campo--->           style="color: blue; text-align:center" | <tem:usuario>
|<!---Descripción--->   Código de país de la dirección para la entrega                       
|<!---Descripción--->     Usuario de Integración Emitido por el Sistema
|<!---Tipo|Longitud---> style="text-align:center;"| AN<nowiki>|</nowiki>2
|<!---Tipo|Longitud--->   style="text-align:center;"|
|<!---Formato--->        style="text-align:center"|  Catálogo N° 04 
|
|<!---Obligatorio--->    style="text-align:center;"|             
|<!---Opcional--->      style="text-align:center;"| F, B   
|-
|-
|<!---Campo--->         style="color: blue; text-align:center"| <per:departamento>
|<!---Campo--->           style="color: blue; text-align:center" | <tem:clave>
|<!---Descripción--->   Departamento de la dirección para la entrega                         
|<!---Descripción--->     Contraseña de Integración Emitido por el Sistema
|<!---Tipo|Longitud---> style="text-align:center;"| AN<nowiki>|</nowiki>...30
|<!---Tipo|Longitud--->   style="text-align:center;"|
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|                 
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|-
|<!---Campo--->         style="color: blue; text-align:center"| <per:direccion>
|<!---Campo--->           style="color: blue; text-align:center" | <tem:documento>
|<!---Descripción--->   Dirección para la entrega
|<!---Descripción--->RUC,Tipo, serie y correlativo de documento a consultar
|<!---Tipo|Longitud---> style="text-align:center;"| AN<nowiki>|</nowiki>...200
|<!---Tipo|Longitud--->   style="text-align:center;"| AN<nowiki>|</nowiki>...16
|<!---Formato--->       style="text-align:center"|  
|<!---Formato--->         style="text-align:center;"| RUC-TT-XZZZ-NNNNNNNN <br/>
|<!---Obligatorio--->   style="text-align:center;"|
  Donde TT hace referencia al tipo de documento según catálogo N° 01 <br/>
|<!---Opcional--->       style="text-align:center;"| F, B   
  X hace referencia al tipo de documento: <br/>
  ZZZ hace referencia a la serie <br/>
  NNNNNNNN hace referencia al correlativo
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:distrito>
|}
|<!---Descripción--->    Distrito de la dirección para la entrega
 
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...30
 
|<!---Formato--->        style="text-align:center"|
===FoliosRestantes===
|<!---Obligatorio--->    style="text-align:center;"|
----
|<!---Opcional--->      style="text-align:center;"| F, B
{| class="wikitable" style="margin: auto;"
! style="text-align:left;" style="color:red"| Descripción
! ''Método para consultarla cantidad de folios restantes para el usuario''
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:paisUsoServicio>
! style="text-align:left;"  style="color:red"| Respuesta Exitosa
|<!---Descripción--->    País de uso del servicio o bien entregado
! ''Código, Mensaje''
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>2
|<!---Formato--->        style="text-align:center"| Catálogo N° 04
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:provincia>
|<!---Descripción--->    Provincia de la dirección para la entrega
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...30
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|  
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:ubigeo>
|<!---Descripción--->    Ubigeo de la dirección para la entrega
|<!---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"| <per:urbanizacion>
|<!---Descripción--->    Urbanización de la dirección para la entrega
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...25
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|  
|<!---Opcional--->      style="text-align:center;"| F, B
|- 
|}
|}


<!----COMPROBANTE---->
===Comprobante===
{| style="text-align:left;"
{| style="text-align:left;"
!Ubicación en Objeto:
!Nombre del método
! style="color: blue" | tem:Enviar/
! style="color: blue" | FoliosRestantes
|-
|-
!Cantidad de Campos:
!Cantidad de Campos:
!style="text-align:left;"|8
!style="text-align:left;"|3
|-
!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;">tem:Enviar/</span>
|-
!Recurrencia de la línea:
! 1
|}
|}


{| class="wikitable" style="margin: auto;"
{| class="wikitable" style="margin: auto;"
!Campo                                   <!----Encabezado de Tabla---->
!Campo
!Descripción
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Tipo<nowiki>|</nowiki>Longitud
!Formato
!Obligatorio
!Opcional                                <!----Encabezado de Tabla FIN---->
|-
|-
|<!---Campo--->         style="color: blue; text-align:center"| <per:codigoTipoOperacion>
|<!---Campo--->           style="color: blue; text-align:center" | <tem:ruc>
|<!---Descripción--->   Código de tipo de operación                       
|<!---Descripción--->     RUC del emisor
|<!---Tipo|Longitud---> style="text-align:center;"| AN<nowiki>|</nowiki>2
|<!---Tipo|Longitud--->   style="text-align:center;"| N<nowiki>|</nowiki>11
|<!---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"| <per:correlativo>
|<!---Campo--->           style="color: blue; text-align:center" | <tem:usuario>
|<!---Descripción--->   Correlativo del documento                         
|<!---Descripción--->     Usuario de Integración Emitido por el Sistema
|<!---Tipo|Longitud---> style="text-align:center;"| N<nowiki>|</nowiki>...8
|<!---Tipo|Longitud--->   style="text-align:center;"|
|<!---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"| <per:fechaEmision>
|<!---Campo--->           style="color: blue; text-align:center" | <tem:clave>
|<!---Descripción--->   Fecha de emisión del documento en curso
|<!---Descripción--->     Contraseña de Integración Emitido por el Sistema
|<!---Tipo|Longitud---> style="text-align:center;"| AN<nowiki>|</nowiki>10
|<!---Tipo|Longitud--->   style="text-align:center;"|
|<!---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"| <per:fechaVencimiento>
|}
|<!---Descripción--->    Fecha de vencimiento del documento
 
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>10
===Reversión===
|<!---Formato--->        style="text-align:center"| YYYY-MM-DD
----
|<!---Obligatorio--->    style="text-align:center;"| F, B
{| class="wikitable" style="margin: auto;"
|<!---Opcional--->      style="text-align:center;"|  
! style="text-align:left;" style="color:red"| Descripción
! ''Método para anular un comprobante de retención o percepción''
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:horaEmision>
! style="text-align:left;"  style="color:red"| Respuesta Exitosa
|<!---Descripción--->    Hora de emisión del documento en curso
! ''Código, Mensaje''
|<!---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"| <per:idTransaccion>
|<!---Descripción--->    Permite tener un control adicional con un ID interno, de lo que envían y reciben. 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
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per: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"| <per: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;"|
|- 
|}
|}


<!----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====
{| style="text-align:left;"
{| style="text-align:left;"
!Ubicación en Objeto:
!Nombre del método
! style="color: blue" | tem:Enviar/tem:documentoElectronico/per:relacionado/per:Relacionado
! style="color: blue" | Reversion
|-
|-
!Cantidad de Campos:
!Cantidad de Campos:
!style="text-align:left;"|5
!style="text-align:left;"|4
|-
!Descripción General:
!style="text-align:left;"| Contiene información de los documentos relacionados con el documento en curso
|-
!Recurrencia de la línea:
! 0...1
|}
|}


{| class="wikitable" style="margin: auto;"
{| class="wikitable" style="margin: auto;"
!Campo                                   <!----Encabezado de Tabla---->
!Campo
!Descripción
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Tipo<nowiki>|</nowiki>Longitud
!Formato
!Formato
!Obligatorio
!Opcional                                <!----Encabezado de Tabla FIN---->
|-
|-
|<!---Campo--->         style="color: blue; text-align:center"| <per:numeroDocRelacionado>
|<!---Campo--->           style="color: blue; text-align:center"| <tem:ruc>
|<!---Descripción--->   Serie y número del documento relacionado con la operación que se factura                     
|<!---Descripción--->     RUC del emisor
|<!---Tipo|Longitud---> style="text-align:center;"| AN<nowiki>|</nowiki>...30
|<!---Tipo|Longitud--->   style="text-align:center;"| N<nowiki>|</nowiki>11
|<!---Formato--->       style="text-align:center"| ZZZZ-NNNNNNNN, donde: <br/>
|
ZZZZ corresponde a la serie <br/>
|-
NNNNNNNN al número de documento 
|<!---Campo--->           style="color: blue; text-align:center" | <tem:usuario>
|<!---Obligatorio--->   style="text-align:center;"|           
|<!---Descripción--->     Usuario de Integración Emitido por el Sistema
|<!---Opcional--->       style="text-align:center;"| F 
|<!---Tipo|Longitud--->   style="text-align:center;"|
|
|-
|-
|<!---Campo--->         style="color: blue; text-align:center"| <per:numeroGRRelacionada>
|<!---Campo--->           style="color: blue; text-align:center" | <tem:clave>
|<!---Descripción--->   Número de la guía de remisión relacionada con la operación que se factura                       
|<!---Descripción--->     Contraseña de Integración Emitido por el Sistema
|<!---Tipo|Longitud---> style="text-align:center;"| AN<nowiki>|</nowiki>...30
|<!---Tipo|Longitud--->   style="text-align:center;"|
|<!---Formato--->        style="text-align:center"|  ZZZZ-NNNNNNNN, donde: <br/>
ZZZZ corresponde a la serie <br/>
NNNNNNNN al número de documento
|<!---Obligatorio--->    style="text-align:center;"|          
|<!---Opcional--->      style="text-align:center;"| F, B, NC   
|-
|-
|<!---Campo--->         style="color: blue; text-align:center"| <per:numeroOrdenCompra>
|<!---Campo--->           style="color: blue; text-align:center" | <tem:documento>
|<!---Descripción--->   Número de la orden de compra
|<!---Descripción--->     Tipo, serie y correlativo de documento a revertir
|<!---Tipo|Longitud---> style="text-align:center;"| AN<nowiki>|</nowiki>...20
|<!---Tipo|Longitud--->   style="text-align:center;"| AN<nowiki>|</nowiki>...16
|<!---Formato--->       style="text-align:center"| Sin espacios, sin guiones, sin salto de línea
|<!---Formato--->         style="text-align:center;"| TT-XZZZ-NNNNNNNN <br/>
|<!---Obligatorio--->   style="text-align:center;"|
  Donde TT hace referencia al tipo de documento según catálogo N° 01 <br/>
|<!---Opcional--->       style="text-align:center;"| F, B, NC   
  X hace referencia al tipo de documento: <br/>
  R: Retenciones <br/>
  P: Percepciones <br/>
  ZZZ hace referencia a la serie <br/>
  NNNNNNNN hace referencia al correlativo
|-
|-
|<!---Campo--->         style="color: blue; text-align:center"| <per:tipoDocRelacionado>
|<!---Campo--->           style="color: blue; text-align:center" | <tem:motivo>
|<!---Descripción--->   Tipo del documento relacionado con la operación que se factura
|<!---Descripción--->     Motivo de la anulación del documento
|<!---Tipo|Longitud---> style="text-align:center;"| N<nowiki>|</nowiki>2
|<!---Tipo|Longitud--->   style="text-align:center;"| AN<nowiki>|</nowiki>...100
|<!---Formato--->        style="text-align:center"| Catálogo N° 01
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:tipoGRRelacionada>
|<!---Descripción--->    Tipo de la guía de remisión relacionada con la operación que se factura
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>2
|<!---Formato--->        style="text-align:center"| Catálogo N° 01
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B, NC
|-
|}
|}


<!----DATOS DE COMPROBANTE RELACIONADO - INFORMACIÓN RELACIONADA A NOTAS DE CRÉDITO Y DÉBITO---->
===ValidaAcceso===
----
{| class="wikitable" style="margin: auto;"
! style="text-align:left;"  style="color:red"| Descripción
! ''Método para validar las credenciales de acceso''
|-
! style="text-align:left;"  style="color:red"| Respuesta Exitosa
! ''Código, Mensaje''
|}


====Datos de Comprobante relacionado – Información relacionada a Notas de Crédito y Débito====
{| style="text-align:left;"
{| style="text-align:left;"
!Ubicación en Objeto:
!Nombre del método
! style="color: blue" | tem:Enviar/tem:documentoElectronico/per:relacionadoNotas
! style="color: blue" | ValidaAcceso
|-
|-
!Cantidad de Campos:
!Cantidad de Campos:
!style="text-align:left;"|4
!style="text-align:left;"|3
|-
!Descripción General:
!style="text-align:left;"| Contiene información de los documentos afectados con la nota de crédito/débito en curso
|-
!Recurrencia de la línea:
! 0...1
|}
|}


{| class="wikitable" style="margin: auto;"
{| class="wikitable" style="margin: auto;"
!Campo                                   <!----Encabezado de Tabla---->
!Campo
!Descripción
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Tipo<nowiki>|</nowiki>Longitud
!Formato
!Obligatorio
!Opcional                                <!----Encabezado de Tabla FIN---->
|-
|-
|<!---Campo--->         style="color: blue; text-align:center"| <per:codigoTipoNota>
|<!---Campo--->           style="color: blue; text-align:center" | <tem:ruc>
|<!---Descripción--->   Código de tipo de nota de crédito o débito
|<!---Descripción--->     RUC del emisor
|<!---Tipo|Longitud---> style="text-align:center;"| AN<nowiki>|</nowiki>2
|<!---Tipo|Longitud--->   style="text-align:center;"| N<nowiki>|</nowiki>11
|<!---Formato--->        style="text-align:center"|  Catálogo N° 09 (Nota de Crédito) <br/>
Catálogo N° 10 (Nota de Débito) 
|<!---Obligatorio--->    style="text-align:center;"| NC, ND           
|<!---Opcional--->      style="text-align:center;"|
|-
|-
|<!---Campo--->         style="color: blue; text-align:center"| <per:numeroDocAfectado>
|<!---Campo--->           style="color: blue; text-align:center" | <tem:usuario>
|<!---Descripción--->   Serie y número del comprobante que se modifica
|<!---Descripción--->     Usuario de Integración Emitido por el Sistema
|<!---Tipo|Longitud---> style="text-align:center;"| AN<nowiki>|</nowiki>...13
|<!---Tipo|Longitud--->   style="text-align:center;"|
|<!---Formato--->        style="text-align:center"|  ZZZZ-NNNNNNNN, donde: <br/>
ZZZZ corresponde a la serie <br/>
NNNNNNNN al número de documento
|<!---Obligatorio--->    style="text-align:center;"| NC, ND         
|<!---Opcional--->      style="text-align:center;"|   
|-
|-
|<!---Campo--->         style="color: blue; text-align:center"| <per:observaciones>
|<!---Campo--->           style="color: blue; text-align:center" | <tem:clave>
|<!---Descripción--->   Motivo de emisión de la nota de crédito o débito
|<!---Descripción--->     Contraseña de Integración Emitido por el Sistema
|<!---Tipo|Longitud---> style="text-align:center;"| AN<nowiki>|</nowiki>...250
|<!---Tipo|Longitud--->   style="text-align:center;"|
|<!---Formato--->        style="text-align:center"| Sin espacios, sin guiones, sin salto de línea
|<!---Obligatorio--->    style="text-align:center;"| NC, ND
|<!---Opcional--->      style="text-align:center;"|  
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:tipoDocAfectado>
|}
|<!---Descripción--->    Tipo de comprobante que se modifica
 
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>2
=== GuiasRemision ===
|<!---Formato--->        style="text-align:center"| Catálogo N° 01
----''Artículo principal:'' [[Web Service SOAP - Método GuiasRemision]]
|<!---Obligatorio--->    style="text-align:center;"| NC, ND
 
|<!---Opcional--->      style="text-align:center;"|
El método '''GuiasRemision''' permite la generación de los siguientes documentos:
* '''Guía Remisión Electrónicas UBL 2.0'''
* '''Guía Remisión Electrónicas UBL 1.0'''
{| class="wikitable" style="margin: auto;"
! style="color:red" | Descripción
! ''Método para enviar documentos (Guías de Remisión 1.0 - 2.0) a OSE/SUNAT''
|-
|-
! style="color:red" | Respuesta Exitosa
! ''Código de aceptación <nowiki>|</nowiki> Mensaje de aceptación <nowiki>|</nowiki> Serie - correlativo del documento y XML timbrado''
|}
|}


<!----PRODUCTO---->
=== CancelarListado ===
----
{| class="wikitable" style="margin: auto;"
! style="color:red" | Descripción
! ''Método para cancelar un listado enviado.''
|-
! style="color:red" | Respuesta Exitosa
! ''Código, Mensaje''
|}


===Producto===
{| style="text-align:left;"
{| style="text-align:left;"
!Ubicación en Objeto:
!Nombre del método
! style="color: blue" | tem:Enviar/tem:documentoElectronico/per:producto/per:Producto
! style="color: blue" | CancelarListado
|-
|-
!Cantidad de Campos:
!Cantidad de Campos:
!style="text-align:left;"|14
! style="text-align:left;" |4
|-
!Descripción General:
!style="text-align:left;"| Contiene información base del producto, de forma individual
|-
!Recurrencia de la línea:
! 1...n
|}
|}


{| class="wikitable" style="margin: auto;"
{| class="wikitable" style="margin: auto;"
!Campo                                   <!----Encabezado de Tabla---->
!Campo
!Descripción
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Tipo<nowiki>|</nowiki>Longitud
!Formato
!Obligatorio
!Opcional                                <!----Encabezado de Tabla FIN---->
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:cantidad>
| style="color: blue; text-align:center" <!---Campo---> | <tem:ruc>
|<!---Descripción--->   Cantidad de unidades del ítem
|<!---Descripción--->RUC del emisor
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,10)
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>11
|<!---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"| <per:codigoGS1>
| style="color: blue; text-align:center" <!---Campo---> | <tem:usuario>
|<!---Descripción--->   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
|<!---Descripción--->Usuario de Integración Emitido por el Sistema
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...14
| style="text-align:center;" <!---Tipo|Longitud---> |
|<!---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"| <per:codigoPLU>
| style="color: blue; text-align:center" <!---Campo---> | <tem:clave>
|<!---Descripción--->   Código de producto del ítem, interno y de uso del establecimiento
|<!---Descripción--->Contraseña de Integración Emitido por el Sistema
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...30
| style="text-align:center;" <!---Tipo|Longitud---> |
|<!---Formato--->       style="text-align:center"| No debe tener saltos de línea
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->       style="text-align:center;"| F, B, NC, ND 
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:codigoPLUSunat>
| style="color: blue; text-align:center" <!---Campo---> | <tem:tipoCancelar>
|<!---Descripción--->   Código de producto (SUNAT), basado en el estándar internacional de la ONU (UNSPSC: ''United Nations Standard Products and Services Code'')
|<!---Descripción--->Tipo de listado a cancelar
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>...8
| style="text-align:center;" <!---Tipo|Longitud---> |
|<!---Formato--->       style="text-align:center"| Catálogo N° 25
|<!---Obligatorio--->    style="text-align:center;"| <nowiki>*</nowiki>
|<!---Opcional--->       style="text-align:center;"| F, B, NC, ND
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:descripcion>
|}
|<!---Descripción--->    Descripción detallada del servicio prestado, bien vendido o cedido en uso, indicando las características
 
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...250
=== Logo ===
|<!---Formato--->        style="text-align:center"|
----
|<!---Obligatorio--->    style="text-align:center;"| F, B, NC, ND
{| class="wikitable" style="margin: auto;"
|<!---Opcional--->      style="text-align:center;"|
! style="color:red" | Descripción
! ''Método de carga del logo de la empresa que se usará para generar electrónicamente las representaciones de documentos y comprobantes consignados a OSE/SUNAT.''
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <detalleProducto>
! style="color:red" | Respuesta Exitosa
|<!---Descripción--->    Informacion adicional para el producto
! ''Código, Mensaje''
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...250
|}
|<!---Formato--->        style="text-align:center"|
 
|<!---Obligatorio--->    style="text-align:center;"|  
{| style="text-align:left;"
|<!---Opcional--->      style="text-align:center;"| F, B, NC, ND
!Nombre del método
! style="color: blue" | Logo
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:montoTotalImpuestoItem>
!Cantidad de Campos:
|<!---Descripción--->    Monto total de impuestos por línea
! style="text-align:left;" |5
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
|}
|<!---Formato--->        style="text-align:center"|
 
|<!---Obligatorio--->    style="text-align:center;"| F, B, NC, ND
{| class="wikitable" style="margin: auto;"
|<!---Opcional--->       style="text-align:center;"|
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:numeroOrden>
| style="color: blue; text-align:center" <!---Campo---> | <tem:ruc>
|<!---Descripción--->   Número de orden del ítem
|<!---Descripción--->RUC del emisor
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>3
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>11
|<!---Formato--->       style="text-align:center"| Ordinal correlativo. no debe superar el número de ítems reportados
|<!---Obligatorio--->   style="text-align:center;"| F, B, NC, ND
|<!---Opcional--->       style="text-align:center;"|
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:numeroPlacaVehiculo>
| style="color: blue; text-align:center" <!---Campo---> | <tem:usuario>
|<!---Descripción--->   Información Adicional - Gastos art.37° Renta
|<!---Descripción--->Usuario de Integración Emitido por el Sistema
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...100
| style="text-align:center;" <!---Tipo|Longitud---> |
|<!---Formato--->       style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->       style="text-align:center;"| F
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:precioVentaUnitarioItem>
| style="color: blue; text-align:center" <!---Campo---> | <tem:clave>
|<!---Descripción--->   Precio de venta unitario. Contiene impuestos
|<!---Descripción--->Contraseña de Integración Emitido por el Sistema
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,10)
| style="text-align:center;" <!---Tipo|Longitud---> |
|<!---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"| <per:unidadMedida>
| style="color: blue; text-align:center" <!---Campo---> | <tem:extension>
|<!---Descripción--->   Código de unidad de medida del ítem
|<!---Descripción--->Extensión de la imagen (jpg, png, ...)
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>3
| style="text-align:center;" <!---Tipo|Longitud---> |
|<!---Formato--->       style="text-align:center"| Catálogo N° 03
|<!---Obligatorio--->    style="text-align:center;"| F, B, NC, ND
|<!---Opcional--->       style="text-align:center;"|  
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:valorReferencialUnitario>
| style="color: blue; text-align:center" <!---Campo---> | <tem:logo>
|<!---Descripción--->   Valor referencial unitario en operaciones no onerosas, para identificar este tipo de operaciones (gratuitas, por ejemplo)
|<!---Descripción--->logo
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,10)
| style="text-align:center;" <!---Tipo|Longitud---> |
|<!---Formato--->       style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"| <nowiki>**</nowiki>
|<!---Opcional--->       style="text-align:center;"| F, B, NC, ND
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:valorUnitarioBI>
|}
|<!---Descripción--->    Valor de venta del ítem, no incluye los impuestos (base imponible)
 
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,10)
=== ListadoSerie===
|<!---Formato--->        style="text-align:center"|
----
|<!---Obligatorio--->    style="text-align:center;"| F, B, NC, ND
{| class="wikitable" style="margin: auto;"
|<!---Opcional--->      style="text-align:center;"|
! style="color:red" | Descripción
|-
! ''Permite realizar una petición para realizar las siguientes acciones por el tipo en las series asociadas a la empresa.''
|<!---Campo--->          style="color: blue; text-align:center"| <per:valorVentaItemQxBI>
|<!---Descripción--->    Valor de venta del ítem (cantidad x base imponible)
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,10)
|<!---Formato--->        style="text-align:center"|
|<!---Obligatorio--->    style="text-align:center;"| F, B, NC, ND
|<!---Opcional--->      style="text-align:center;"|
|-
|-
! style="color:red" | Respuesta Exitosa
! ''Código (devuelve 0 si es exitoso), Mensaje''
|}
|}
<nowiki>*</nowiki>: Este valor deberá ser obligatorio para las facturas de exportación <br/>
<nowiki>**</nowiki>: Se enviará este campo cuando el producto esté involucrado en una operación no onerosa


<!----PRODUCTO - IGV SOBRE ITEM---->
====Producto - IGV sobre ítem====
{| style="text-align:left;"
{| style="text-align:left;"
!Ubicación en Objeto:
!Nombre del método
! style="color: blue" | tem:Enviar/tem:documentoElectronico/per:producto/per:Producto/per:IGV/per:ProductoIGV
! style="color: blue" | ListadoSerie
|-
|-
!Cantidad de Campos:
!Cantidad de Campos:
!style="text-align:left;"|4
! style="text-align:left;" |9
|}
 
{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:ruc>
|<!---Descripción--->RUC del emisor
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>11
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:usuario>
|<!---Descripción--->Usuario de Integración
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:clave>
|<!---Descripción--->Clave de Integración
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
|-
!Descripción General:  
| style="color: blue; text-align:center" <!---Campo---> | <tem:tipo>
!style="text-align:left;"| Contiene información del IGV que afecta al producto
|<!---Descripción--->Tipo de acción a realizar
| style="text-align:center;" <!---Tipo|Longitud---> |Tipo 1: Te permite crear una serie
Tipo 2: Busca todas las series que posee la empresa.
 
Tipo 3: Actualiza la serie por nomenclatura de la serie
 
Tipo 4: Elimina la serie por nomenclatura de la serie
 
|-
|-
!Recurrencia de la línea:
! 1...n
|}
|}


{| class="wikitable" style="margin: auto;"
{| class="wikitable" style="margin: auto;"
!Campo                                   <!----Encabezado de Tabla---->
!Campo
!Descripción
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Tipo<nowiki>|</nowiki>Longitud
!Formato
!Formato
!Obligatorio
!Opcional                                <!----Encabezado de Tabla FIN---->
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:baseImponible>
| style="color: blue; text-align:center" <!---Campo---> | <per:folio_actual>
|<!---Descripción--->   Monto de la operación, base imponible sobre la que se calculará el impuesto
|<!---Descripción--->Folio Actual de la Serie
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
| style="text-align:center;" <!---Tipo|Longitud---> | 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"| <per:monto>
| style="color: blue; text-align:center" <!---Campo---> | <per:folio_inicial>
|<!---Descripción--->   Monto de tributo del ítem
|<!---Descripción--->Folio Inicial de la Serie
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
| style="text-align:center;" <!---Tipo|Longitud---> | 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"| <per:porcentaje>
| style="color: blue; text-align:center" <!---Campo---> | <per:serie>
|<!---Descripción--->   Porcentaje del impuesto IGV
|<!---Descripción--->Nomenclatura de la Serie
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(3,5)
| style="text-align:center;" <!---Tipo|Longitud---> | AN<nowiki>|</nowiki>4
|<!---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"| <per:tipo>
| style="color: blue; text-align:center" <!---Campo---> | <per:tipo_asignacion>
|<!---Descripción--->   Código de tipo de afectación del IGV
|<!---Descripción--->Tipo de Asignación Manual o Automático
|<!---Tipo|Longitud---> style="text-align:center;"| AN<nowiki>|</nowiki>2
| style="text-align:center;" <!---Tipo|Longitud---> | A<nowiki>|</nowiki>1
|<!---Formato--->        style="text-align:center"| Catálogo N° 07
|Automático : A <br> Manual : M
|<!---Obligatorio--->   style="text-align:center;"| F, B, NC, ND
|-
|<!---Opcional--->       style="text-align:center;"|  
| style="color: blue; text-align:center" <!---Campo---> | <per:tipo_documento>
|<!---Descripción--->Tipo de Documento asociado a la Serie
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>2
| Catálogo N°01
|-
|-
|}
|}


<!----PRODUCTO - IVAP SOBRE ITEM---->
=== ListadoSucursal ===
----
{| class="wikitable" style="margin: auto;"
! style="color:red" | Descripción
! ''Permite realizar una petición para realizar las siguientes acciones por el tipo en las sucursales asociadas a la empresa.''
|-
! style="color:red" | Respuesta Exitosa
! ''Código (devuelve 0 si es exitoso), Mensaje''
|}


====Producto - IVAP sobre ítem====
{| style="text-align:left;"
{| style="text-align:left;"
!Ubicación en Objeto:
!Nombre del método
! style="color: blue" | tem:Enviar/tem:documentoElectronico/per:producto/per:Producto/per:IVAP/per:ProductoIVAP
! style="color: blue" | ListadoSucursal
|-
|-
!Cantidad de Campos:
!Cantidad de Campos:
!style="text-align:left;"|4
! style="text-align:left;" |4 -11
|}
 
{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:ruc>
|<!---Descripción--->RUC del emisor
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>11
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:token>
|<!---Descripción--->Token de acceso
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
|-
!Descripción General:  
| style="color: blue; text-align:center" <!---Campo---> | <tem:serial>
!style="text-align:left;"| Contiene información del IVAP que afecta al producto
|<!---Descripción--->Serial del dispositivo
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:tipo>
|<!---Descripción--->Tipo de acción a realizar
| style="text-align:center;" <!---Tipo|Longitud---> |Tipo 1: te permite crear una sucursal
Tipo 2: busca todas las sucursales asociadas a la empresa.
 
Tipo 3: Actualiza la sucursal por código.
 
Tipo 4: Borra la sucursal por código.
|-
|-
!Recurrencia de la línea:
! 0...n
|}
|}
 
Datos Sucursal (Objeto / Listado)
{| class="wikitable" style="margin: auto;"
{| class="wikitable" style="margin: auto;"
!Campo                                   <!----Encabezado de Tabla---->
!Campo
!Descripción
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Tipo<nowiki>|</nowiki>Longitud
!Formato
!Obligatorio
!Opcional                                <!----Encabezado de Tabla FIN---->
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:baseImponible>
| style="color: blue; text-align:center" <!---Campo---> | <tem:codigo>
|<!---Descripción--->   Monto de la operación, base imponible sobre la que se calculará el impuesto
|<!---Descripción--->código de la sucursal
|<!---Tipo|Longitud---> style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
| style="text-align:center;" <!---Tipo|Longitud---> | string
|<!---Formato--->       style="text-align:center"| 
|-
|<!---Obligatorio--->   style="text-align:center;"|            
| style="color: blue; text-align:center" <!---Campo---> | <tem:descripcion>
|<!---Opcional--->       style="text-align:center;"| F, B, NC, ND
|<!---Descripción--->Descripción de la sucursal
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:direccion>
|<!---Descripción--->Dirección de la sucursal
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:monto>
| style="color: blue; text-align:center" <!---Campo---> | <tem:pais>
|<!---Descripción--->   Monto de tributo del ítem
|<!---Descripción--->Siglas del país Ejemplo: PE
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
| style="text-align:center;" <!---Tipo|Longitud---> |
|<!---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"| <per:porcentaje>
| style="color: blue; text-align:center" <!---Campo---> | <tem:telefono>
|<!---Descripción--->   Porcentaje del impuesto IVAP
|<!---Descripción--->Teléfonos de la sucursal
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(3,5)
| style="text-align:center;" <!---Tipo|Longitud---> |
|<!---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"| <per:tipo>
| style="color: blue; text-align:center" <!---Campo---> |<tem:tipoEstablecimiento>
|<!---Descripción--->   Código de tipo de afectación del IVAP
|<!---Descripción--->Tipo de establecimiento
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>2
|
|<!---Formato--->       style="text-align:center"| Catálogo N° 07
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B, NC, ND
|-
|-
| style="color: blue; text-align:center" <!---Campo---> |<tem:ubigeo>
|<!---Descripción--->Codigo ubigeo de la ubicación de la sucursal
|
|}
|}


<!----PRODUCTO - ISC SOBRE ITEM---->
=== ListadoProductos ===
----
{| class="wikitable" style="margin: auto;"
! style="color:red" | Descripción
! ''Permite realizar el listado , creación , actualización y eliminación de los distintos productos.''
|-
! style="color:red" | Respuesta Exitosa
! ''Código (devuelve 0 si es exitoso), Mensaje''
|}


====Producto - ISC sobre ítem====
{| style="text-align:left;"
{| style="text-align:left;"
!Ubicación en Objeto:
!Nombre del método
! style="color: blue" | tem:Enviar/tem:documentoElectronico/per:producto/per:Producto/per:ISC/per:ProductoISC
! style="color: blue" | ListadoProductos
|-
|-
!Cantidad de Campos:
!Cantidad de Campos:
!style="text-align:left;"|4
! style="text-align:left;" |11
|}
 
{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:ruc>
|<!---Descripción--->RUC del emisor
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>11
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:usuario>
|<!---Descripción--->Usuario de Integración
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
|-
!Descripción General:  
| style="color: blue; text-align:center" <!---Campo---> | <tem:clave>
!style="text-align:left;"| Contiene información del ISC que afecta al producto
|<!---Descripción--->Clave de Integración
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:tipo>
|<!---Descripción--->Tipo de acción a realizar
| style="text-align:center;" <!---Tipo|Longitud---> |Tipo 1: Te permite crear un producto
Tipo 2: Busca todos los productos que posee la empresa.
 
Tipo 3: Actualiza el producto por códigoUser
 
Tipo 4: Elimina el producto por códigoUser
 
|-
|-
!Recurrencia de la línea:
! 0...n
|}
|}


{| class="wikitable" style="margin: auto;"
{| class="wikitable" style="margin: auto;"
!Campo                                   <!----Encabezado de Tabla---->
!Campo
!Descripción
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Tipo<nowiki>|</nowiki>Longitud
!Formato
!Formato
!Obligatorio
!Opcional                                <!----Encabezado de Tabla FIN---->
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:baseImponible>
| style="color: blue; text-align:center" <!---Campo---> | <per:codigoGs1>
|<!---Descripción--->   Monto de la operación, base imponible sobre la que se calculará el impuesto
|<!---Descripción--->Código GS1 del Producto.
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>13
|<!---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"| <per:monto>
| style="color: blue; text-align:center" <!---Campo---> | <per:codigoSunat>
|<!---Descripción--->   Monto de tributo del ítem
|<!---Descripción--->Código Sunat del Producto.
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>8
|<!---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"| <per:porcentaje>
| style="color: blue; text-align:center" <!---Campo---> | <per:codigoUser>
|<!---Descripción--->   Porcentaje del impuesto ISC
|<!---Descripción--->Código del Producto que asigna el Usuario internamente.
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(3,5)
| style="text-align:center;" <!---Tipo|Longitud---> | AN<nowiki>|</nowiki>30
|<!---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"| <per:tipo>
| style="color: blue; text-align:center" <!---Campo---> | <per:descripcion>
|<!---Descripción--->   Código de tipo de afectación del ISC
|<!---Descripción--->Descripción del Producto
|<!---Tipo|Longitud---> style="text-align:center;"| AN<nowiki>|</nowiki>2
| style="text-align:center;" <!---Tipo|Longitud---> | AN<nowiki>|</nowiki>500
|<!---Formato--->       style="text-align:center"| Catálogo N° 08
|
|<!---Obligatorio--->   style="text-align:center;"|  
|-
|<!---Opcional--->       style="text-align:center;"| F, B, NC, ND
| style="color: blue; text-align:center" <!---Campo---> | <per:impuesto>
|<!---Descripción--->Código de Tipo de Afectación del IGV
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>4
| Catálogo N°07
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:unidad>
|<!---Descripción--->Unidad de Medida del Producto
| style="text-align:center;" <!---Tipo|Longitud---> |AN<nowiki>|</nowiki>3
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:valorUnitario>
|<!---Descripción--->Valor Unitario del Producto
| style="text-align:center;" <!---Tipo|Longitud---> |12,10
|
|-
|-
|}
|}
'''Nota''': Si se envía información en un campo, todos los demás deben enviarse


<!----PRODUCTO - OTROS TRIBUTOS SOBRE ITEM - ICBPER---->
=== ListadoClientes===
----
{| class="wikitable" style="margin: auto;"
! style="color:red" | Descripción
! ''Permite realizar una petición para realizar las siguientes acciones por el tipo en los clientes asociados a la empresa.''
|-
! style="color:red" | Respuesta Exitosa
! ''Código (devuelve 0 si es exitoso), Mensaje''
|}


====Producto - Otros Tributos sobre ítem - ICBPER====
{| style="text-align:left;"
{| style="text-align:left;"
!Ubicación en Objeto:
!Nombre del método
! style="color: blue" | tem:Enviar/tem:documentoElectronico/per:producto/per:Producto/ per:otrosTributos/per:ProductoOtrosTributos
! style="color: blue" | ListadoClientes
|-
|-
!Cantidad de Campos:
!Cantidad de Campos:
!style="text-align:left;"|4
! style="text-align:left;" |9
|-
!Descripción General:
!style="text-align:left;"| : Contiene información de otros impuestos que afectan al producto
|-
!Recurrencia de la línea:
! 0...n
|}
|}


{| class="wikitable" style="margin: auto;"
{| class="wikitable" style="margin: auto;"
!Campo                                   <!----Encabezado de Tabla---->
!Campo
!Descripción
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Tipo<nowiki>|</nowiki>Longitud
!Formato
!Obligatorio
!Opcional                                <!----Encabezado de Tabla FIN---->
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:baseImponible>
| style="color: blue; text-align:center" <!---Campo---> | <tem:ruc>
|<!---Descripción--->   Monto de la operación, base imponible sobre la que se calculará el impuesto <br/>
|<!---Descripción--->RUC del emisor
Cantidad de bolsas de plástico
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>11
|<!---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"| <per:monto>
| style="color: blue; text-align:center" <!---Campo---> | <tem:usuario>
|<!---Descripción--->   Monto de tributo del ítem <br/>
|<!---Descripción--->Usuario de Integración
Cantidad de bolsas multiplicado por el valor unitario de la misma
| style="text-align:center;" <!---Tipo|Longitud---> |
|<!---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"| <per:porcentaje>
| style="color: blue; text-align:center" <!---Campo---> | <tem:clave>
|<!---Descripción--->   Tasa de porcentaje de otros impuestos <br/>
|<!---Descripción--->Clave de Integración
Valor unitario de la bolsa de plástico
| style="text-align:center;" <!---Tipo|Longitud---> |
|<!---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 
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:tipo>
| style="color: blue; text-align:center" <!---Campo---> | <tem:tipo>
|<!---Descripción--->   Código de tipo de afectación de otros impuestos
|<!---Descripción--->Tipo de acción a realizar
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>4
| style="text-align:center;" <!---Tipo|Longitud---> |Tipo 1: Te permite crear un cliente
|<!---Formato--->       style="text-align:center"| Catálogo N° 05
Tipo 2: Busca todos los clientes que posee la empresa.
|<!---Obligatorio--->    style="text-align:center;"|
 
|<!---Opcional--->       style="text-align:center;"| F, B, NC, ND
Tipo 3: Actualiza la información del cliente por RUC
 
Tipo 4: Elimina la información del cliente por RUC
 
|-
|-
|}
|}
'''Nota''': Si se envía información en un campo, todos los demás deben enviarse


<!----PRODUCTO - DESCUENTOS SOBRE ITEM---->


====Producto - Descuentos sobre ítem====
 
{| style="text-align:left;"
!Ubicación en Objeto:
! style="color: blue" | tem:Enviar/tem:documentoElectronico/per:producto/per:Producto/per:descuento/per:ProductoDescuento
|-
!Cantidad de Campos:
!style="text-align:left;"|4
|-
!Descripción General:
!style="text-align:left;"| : Contiene información del descuento que afecta al producto
|-
!Recurrencia de la línea:
! 0...1
|}


{| class="wikitable" style="margin: auto;"
{| class="wikitable" style="margin: auto;"
!Campo                                   <!----Encabezado de Tabla---->
!Campo
!Descripción
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Tipo<nowiki>|</nowiki>Longitud
!Formato
!Formato
!Obligatorio
!Opcional                                <!----Encabezado de Tabla FIN---->
|-
|-
|<!---Campo--->         style="color: blue; text-align:center"| <per:baseImponible>
| style="color: blue; text-align:center" <!---Campo---> | <per:direccion>
|<!---Descripción--->   Monto de la operación, base imponible sobre la que se calculará el descuento
|<!---Descripción--->Dirección
|<!---Tipo|Longitud---> style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
| style="text-align:center;" <!---Tipo|Longitud---> | AN<nowiki>|</nowiki>200
|<!---Formato--->       style="text-align:center"|
|
|<!---Obligatorio--->   style="text-align:center;"|            
|-
|<!---Opcional--->       style="text-align:center;"| F, B, NC, ND
| style="color: blue; text-align:center" <!---Campo---> | <per:email>
|<!---Descripción--->Correo Electrónico del Cliente
| style="text-align:center;" <!---Tipo|Longitud---> | AN<nowiki>|</nowiki>200
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:enviarEmail>
|<!---Descripción--->Activar Notificaciones Via Correo Electrónico
| style="text-align:center;" <!---Tipo|Longitud---> | A<nowiki>|</nowiki>2
|SI o NO
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:numDocumento>
|<!---Descripción--->Número de Documento del Cliente
| style="text-align:center;" <!---Tipo|Longitud---> | AN<nowiki>|</nowiki>15
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:pais>
|<!---Descripción--->País del Cliente
| style="text-align:center;" <!---Tipo|Longitud---> | A<nowiki>|</nowiki>2
|Catálogo N°04
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:razonSocial>
|<!---Descripción--->Razón Social del Cliente
| style="text-align:center;" <!---Tipo|Longitud---> | AN<nowiki>|</nowiki>100
|
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:monto>
| style="color: blue; text-align:center" <!---Campo---> | <per:telefono>
|<!---Descripción--->   Monto de descuento a aplicar sobre el ítem
|<!---Descripción--->Número de Telefono del Cliente
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>15
|<!---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"| <per:porcentaje>
| style="color: blue; text-align:center" <!---Campo---> | <per:tipoDocumento>
|<!---Descripción--->   Tasa de porcentaje del descuento a aplicar sobre el ítem
|<!---Descripción--->Tipo de Documento del Cliente
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(3,5)
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>2
|<!---Formato--->       style="text-align:center"|
| Catálogo N°06
|<!---Obligatorio--->   style="text-align:center;"|
|<!---Opcional--->       style="text-align:center;"| F, B, NC, ND 
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:codigo>
| style="color: blue; text-align:center" <!---Campo---> | <per:ubigeo>
|<!---Descripción--->   Código de tipo de descuento a aplicar
|<!---Descripción--->Ubigeo de la Dirección del Cliente
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>2
| style="text-align:center;" <!---Tipo|Longitud---> | N<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
|-
|-
|}
|}
'''Nota''': Si se envía información en un campo, todos los demás deben enviarse


<!----PRODUCTO - CARGOS SOBRE ITEM---->


====Producto - Cargos sobre ítem====
 
 
=== EnvioCorreo===
----
{| class="wikitable" style="margin: auto;"
! style="color:red" | Descripción
! ''Permite enviar via correo electrónico los archivos XML,PDF y CDR ''
|-
! style="color:red" | Respuesta Exitosa
! ''Código (devuelve 0 si es exitoso), Mensaje''
|}
 
{| style="text-align:left;"
{| style="text-align:left;"
!Ubicación en Objeto:
!Nombre del método
! style="color: blue" | tem:Enviar/tem:documentoElectronico/per:producto/per:Producto/per:cargo/per:ProductoCargo
! style="color: blue" | EnvioCorreo
|-
|-
!Cantidad de Campos:
!Cantidad de Campos:
!style="text-align:left;"|4
! style="text-align:left;" |11
|-
!Descripción General:
!style="text-align:left;"| : Contiene información del cargo que afecta al producto
|-
!Recurrencia de la línea:
! 0...1
|}
|}


{| class="wikitable" style="margin: auto;"
{| class="wikitable" style="margin: auto;"
!Campo                                   <!----Encabezado de Tabla---->
!Campo
!Descripción
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Tipo<nowiki>|</nowiki>Longitud
!Formato
!Formato
!Obligatorio
!Opcional                                <!----Encabezado de Tabla FIN---->
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:baseImponible>
| style="color: blue; text-align:center" <!---Campo---> | <tem:ruc>
|<!---Descripción--->   Monto de base del cargo del ítem, base imponible sobre la que se calculará el cargo
|<!---Descripción--->RUC del emisor
|<!---Tipo|Longitud---> style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>11
|<!---Formato--->        style="text-align:center"|
|
|<!---Obligatorio--->   style="text-align:center;"|           
|-
|<!---Opcional--->       style="text-align:center;"| F, B, NC, ND
| style="color: blue; text-align:center" <!---Campo---> | <tem:usuario>
|<!---Descripción--->Usuario de Integración
| style="text-align:center;" <!---Tipo|Longitud---> |
|
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:monto>
| style="color: blue; text-align:center" <!---Campo---> | <tem:clave>
|<!---Descripción--->   Monto de cargo a aplicar sobre el ítem
|<!---Descripción--->Clave de Integración
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
| style="text-align:center;" <!---Tipo|Longitud---> |
|<!---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"| <per:porcentaje>
| style="color: blue; text-align:center" <!---Campo---> | <tem:numeracion>
|<!---Descripción--->   Tasa de porcentaje del cargo a aplicar sobre el ítem
|<!---Descripción--->Numeración del Documento a Enviar
|<!---Tipo|Longitud---> style="text-align:center;"| N<nowiki>|</nowiki>(3,5)
| style="text-align:center;" <!---Tipo|Longitud---> |AN<nowiki>|</nowiki>13
|<!---Formato--->        style="text-align:center"|
| style="text-align:center;" <!---Formato---> |ZZZZ-NNNNNNNN, donde: <br/>
|<!---Obligatorio--->   style="text-align:center;"|
ZZZZ corresponde a la serie <br/>
|<!---Opcional--->       style="text-align:center;"|  F, B, NC, ND 
NNNNNNNN al número de documento
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:codigo>
| style="color: blue; text-align:center" <!---Campo---> | <tem:tipo>
|<!---Descripción--->   Código de tipo de descuento a aplicar
|<!---Descripción--->Tipo de Documento
|<!---Tipo|Longitud---> style="text-align:center;"| AN<nowiki>|</nowiki>2
| style="text-align:center;" <!---Tipo|Longitud---> |N<nowiki>|</nowiki>2
|<!---Formato--->       style="text-align:center"| Catálogo N° 53
| style="text-align:center;" <!---Formato---> |Catálogo N° 06
|<!---Obligatorio--->   style="text-align:center;"|
|-
|<!---Opcional--->       style="text-align:center;"| F, B, NC, ND
| style="color: blue; text-align:center" <!---Campo---> | <tem:destinatarios>
|<!---Descripción--->Correo electronico del destinatario. Debe ser una dirección válida para el envío correcto del documento electrónico.
Para enviar varios correos, deben separarse con el caracter , (coma) o ; (punto y coma)
| style="text-align:center;" <!---Tipo|Longitud---> |AN<nowiki>|</nowiki>2000
|
|-
|-
|}
|}
'''Nota''': Si se envía información en un campo, todos los demás deben enviarse


<!----DESCUENTOS GLOBALES---->
=== EstatusCorreo===
----
{| class="wikitable" style="margin: auto;"
! style="color:red" | Descripción
! ''Permite realizar una petición para obtener información sobre el historial de envios del documento consultado.''
|-
! style="color:red" | Respuesta Exitosa
! ''Código (devuelve 0 si es exitoso), Mensaje''
|}


===Descuentos Globales===
{| style="text-align:left;"
{| style="text-align:left;"
!Ubicación en Objeto:
!Nombre del método
! style="color: blue" | tem:Enviar/tem:documentoElectronico/per:descuentosGlobales
! style="color: blue" | EstatusCorreo
|-
|-
!Cantidad de Campos:
!Cantidad de Campos:
!style="text-align:left;"|4
! style="text-align:left;" |3
|-
!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;"
{| class="wikitable" style="margin: auto;"
!Campo                                   <!----Encabezado de Tabla---->
!Campo
!Descripción
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Tipo<nowiki>|</nowiki>Longitud
!Formato
!Formato
!Obligatorio
!Opcional                                <!----Encabezado de Tabla FIN---->
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:baseImponible>
| style="color: blue; text-align:center" <!---Campo---> | <tem:usuario>
|<!---Descripción--->   Monto de base imponible de descuento global
|<!---Descripción--->Usuario de Integración
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
| style="text-align:center;" <!---Tipo|Longitud---> |  
|<!---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"| <per:monto>
| style="color: blue; text-align:center" <!---Campo---> | <tem:clave>
|<!---Descripción--->   Monto total del descuento global. '''Forma parte de los totales del documento'''
|<!---Descripción--->Clave de Integración
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
| style="text-align:center;" <!---Tipo|Longitud---> |
|<!---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"| <per:motivo>
| style="color: blue; text-align:center" <!---Campo---> | <tem:documento>
|<!---Descripción--->   Código del motivo del descuento
|<!---Descripción--->Número de Documento a Consultar
|<!---Tipo|Longitud---> style="text-align:center;"| AN<nowiki>|</nowiki>...2
| style="text-align:center;" <!---Tipo|Longitud---> | AN<nowiki>|</nowiki>28
|<!---Formato--->       style="text-align:center"| Catálogo N° 53
|RUC-TipoDeDocumento-Serie-Correlativo
|<!---Obligatorio--->   style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"|  F, B, NC, ND 
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per: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;"|  
=== DescargarListado ===
|<!---Opcional--->      style="text-align:center;"| F, B, NC, ND
----
{| class="wikitable" style="margin: auto;"
! style="color:red" | Descripción
! ''Permite Descargar los Listados''
|-
|-
! style="color:red" | Respuesta Exitosa
! ''Código (devuelve 0 si es exitoso), Mensaje''
|}
|}
'''Nota''': Si se envía información en un campo, todos los demás deben enviarse
<!----CARGOS GLOBALES---->


===Cargos Globales===
{| style="text-align:left;"
{| style="text-align:left;"
!Ubicación en Objeto:
!Nombre del método
! style="color: blue" | tem:Enviar/tem:documentoElectronico/per:cargosGlobales
! style="color: blue" | DescargarListado
|-
|-
!Cantidad de Campos:
!Cantidad de Campos:
!style="text-align:left;"|4
! style="text-align:left;" |5
|-
!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;"
{| class="wikitable" style="margin: auto;"
!Campo                                   <!----Encabezado de Tabla---->
!Campo
!Descripción
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Tipo<nowiki>|</nowiki>Longitud
!Formato
!Formato
!Obligatorio
!Opcional                                <!----Encabezado de Tabla FIN---->
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:baseImponible>
| style="color: blue; text-align:center" <!---Campo---> | <tem:ruc>
|<!---Descripción--->   Monto de base imponible de cargo global
|<!---Descripción--->RUC del emisor
|<!---Tipo|Longitud---> style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>11
|<!---Formato--->        style="text-align:center"|
|
|<!---Obligatorio--->   style="text-align:center;"|           
|-
|<!---Opcional--->       style="text-align:center;"| F, B, NC, ND
| style="color: blue; text-align:center" <!---Campo---> | <tem:usuario>
|<!---Descripción--->Usuario de Integración
| style="text-align:center;" <!---Tipo|Longitud---> |
|
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:monto>
| style="color: blue; text-align:center" <!---Campo---> | <tem:clave>
|<!---Descripción--->   Monto total del cargo global. '''Forma parte de los totales del documento'''
|<!---Descripción--->Clave de Integración
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
| style="text-align:center;" <!---Tipo|Longitud---> |
|<!---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"| <per:motivo>
| style="color: blue; text-align:center" <!---Campo---> | <tem:lote>
|<!---Descripción--->   Código del motivo del cargo
|<!---Descripción--->Numeración del lote
|<!---Tipo|Longitud---> style="text-align:center;"| AN<nowiki>|</nowiki>...2
| style="text-align:center;" <!---Tipo|Longitud---> |
|<!---Formato--->       style="text-align:center"| Catálogo N° 53
| style="text-align:center;" <!---Formato---> |
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->       style="text-align:center;"| F, B, NC, ND 
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:porcentaje>
| style="color: blue; text-align:center" <!---Campo---> | <tem:ticket>
|<!---Descripción--->   Factor de porcentaje del cargo global
|<!---Descripción--->numero del ticket (respuesta de GeneraListado)
|<!---Tipo|Longitud---> style="text-align:center;"| N<nowiki>|</nowiki>(3,5)
| style="text-align:center;" <!---Tipo|Longitud---> |
|<!---Formato--->       style="text-align:center"|  
| style="text-align:center;" <!---Formato---> |
|<!---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


<!----PERCEPCIONES-------->
=== Retención/Percepción ===
{| class="wikitable" style="margin: auto;"
! style="color:red" | Descripción
! ''Permite enviar via correo electrónico los archivos XML,PDF y CDR ''
|-
! style="color:red" | Respuesta Exitosa
! ''Código (devuelve 0 si es exitoso), Mensaje''
|}


===Percepciones===
{| style="text-align:left;"
{| style="text-align:left;"
!Ubicación en Objeto:
!Nombre del método
! style="color: blue" | tem:Enviar/tem:documentoElectronico/per:percepción
! style="color: blue" | RetencionPercepcion
|-
|-
!Cantidad de Campos:
!Cantidad de Campos:
!style="text-align:left;"|4
! style="text-align:left;" |5
|-
!Descripción General:
!style="text-align:left;"| : Contiene información del pago que acredita la percepción
|-
!Recurrencia de la línea:
! 0...1
|}
|}
 
''Artículo principal:'' [[Web Service SOAP - Método Retención/Percepción|Web Service SOAP - Método RetenciónPercción]]
{| class="wikitable" style="margin: auto;"
{| class="wikitable" style="margin: auto;"
!Campo                                   <!----Encabezado de Tabla---->
!Campo
!Descripción
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Tipo<nowiki>|</nowiki>Longitud
!Formato
!Formato
!Obligatorio
!Opcional                                <!----Encabezado de Tabla FIN---->
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:baseImponible>
| style="color: blue; text-align:center" <!---Campo---> | <tem:ruc>
|<!---Descripción--->   Base imponible sobre la que será calculada la percepción
|<!---Descripción--->RUC del emisor
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>11
|<!---Formato--->       style="text-align:center"| 
|
|<!---Obligatorio--->   style="text-align:center;"|            
|<!---Opcional--->       style="text-align:center;"| F
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:codigo>
| style="color: blue; text-align:center" <!---Campo---> | <tem:usuario>
|<!---Descripción--->   Código de tipo de monto de la percepción (motivo)
|<!---Descripción--->Usuario de Integración
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>2
| style="text-align:center;" <!---Tipo|Longitud---> |AN
|<!---Formato--->       style="text-align:center"|  Catálogo N° 53
|
|<!---Obligatorio--->    style="text-align:center;"|           
|<!---Opcional--->       style="text-align:center;"| F 
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:monto>
| style="color: blue; text-align:center" <!---Campo---> | <tem:clave>
|<!---Descripción--->   Monto total de la percepción
|<!---Descripción--->Clave de Integración
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
| style="text-align:center;" <!---Tipo|Longitud---> |AN
|<!---Formato--->       style="text-align:center"|
|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->       style="text-align:center;"| F
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:porcentaje>
| style="color: blue; text-align:center" <!---Campo---> | <tem:layout>
|<!---Descripción--->   Factor de la percepción
|<!---Descripción--->Archivo TXT en base64
|<!---Tipo|Longitud---> style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
| style="text-align:center;" <!---Tipo|Longitud---> |AN
|<!---Formato--->       style="text-align:center"|  
| style="text-align:center;" <!---Formato---> |
|<!---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


<!----DETRACCIONES-------->
=== Estatus===
----
{| class="wikitable" style="margin: auto;"
! style="color:red" | Descripción
! ''Permite realizar una petición para obtener el estado de las credenciales de integración''
|-
! style="color:red" | Respuesta Exitosa
! ''Código (devuelve 0 si es exitoso), Mensaje''
|}


===Detracciones===
{| style="text-align:left;"
{| style="text-align:left;"
!Ubicación en Objeto:
!Nombre del método
! style="color: blue" | tem:Enviar/tem:documentoElectronico/per:detracción/per:Detraccion
! style="color: blue" | Estatus
|-
|-
!Cantidad de Campos:
!Cantidad de Campos:
!style="text-align:left;"|5
! style="text-align:left;" |4
|-
!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;"
{| class="wikitable" style="margin: auto;"
!Campo                                   <!----Encabezado de Tabla---->
!Campo
!Descripción
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Tipo<nowiki>|</nowiki>Longitud
!Formato
!Formato
!Obligatorio
!Opcional                                <!----Encabezado de Tabla FIN---->
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| < per:codigo>
| style="color: blue; text-align:center" <!---Campo---> | <tem:ruc>
|<!---Descripción--->   Código del bien o producto sujeto a detracción
|<!---Descripción--->Ruc de la empresa
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>2
| style="text-align:center;" <!---Tipo|Longitud--->N|11
|<!---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"| <per:medioPago>
| style="color: blue; text-align:center" <!---Campo---> | <tem:usuario>
|<!---Descripción--->   Medio de pago de la detracción
|<!---Descripción--->Usuario de Integración
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>3
| style="text-align:center;" <!---Tipo|Longitud---> | AN
|<!---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"| <per:monto>
| style="color: blue; text-align:center" <!---Campo---> | <tem:clave>
|<!---Descripción--->   Monto de la detracción
|<!---Descripción--->Clave de Integración
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>(12,2)
| style="text-align:center;" <!---Tipo|Longitud---> |AN
|<!---Formato--->       style="text-align:center"|
|
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->       style="text-align:center;"| F, B
|-
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per:numCuentaBancodelaNacion>
| style="color: blue; text-align:center" <!---Campo---> | <tem:tipoaplicacion>
|<!---Descripción--->   Número Cuenta del Banco de la Nación
|<!---Descripción--->Tipo de aplicación que se consulta
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...100
| style="text-align:center;" <!---Tipo|Longitud---> | <nowiki>AN|1</nowiki>
|<!---Formato--->       style="text-align:center"|
|I
|<!---Obligatorio--->    style="text-align:center;"|
|<!---Opcional--->      style="text-align:center;"| F, B
|-
|<!---Campo--->          style="color: blue; text-align:center"| <per: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
==Método ==
==Método ==
==Método ==

Revisión actual del 17:40 10 mar 2025

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.

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.

Enviar

Artículo principal: Web Service SOAP - Método Enviar

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
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

CargarCertificado

Descripción Método de carga de certificado electrónico en la cuenta del usuario que se usará para firmar electrónicamente los documentos y comprobantes a consignar para OSE/SUNAT.
Respuesta Exitosa Código, Mensaje
Nombre del método CargarCertificado
Cantidad de Campos: 5
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
<tem:certificadoBase64> Certificado autorizado, cifrado en base 64
<tem:certificadoClaveBase64> Clave del certificado, cifrada en base 64

ComunicacionBaja

Descripción Método para dar de baja a los documentos de venta (factura, boleta de venta, nota de crédito y nota de débito) enviados al OSE/SUNAT
Respuesta Exitosa Código, Mensaje
Nombre del método ComunicacionBaja
Cantidad de Campos: 5
Campo Descripción Tipo|Longitud Formato
<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
<tem:documento> Tipo, serie y correlativo de documento a dar de baja AN|...16 TT-XZZZ-NNNNNNNN

Donde TT hace referencia al tipo de documento según catálogo N° 01
X hace referencia al tipo de documento:
F: Factura o notas asociadas
B: Boletas o notas asociadas
ZZZ hace referencia a la serie
NNNNNNNN hace referencia al correlativo

<tem:motivo> Motivo de la anulación del documento AN|...100

DescargaArchivo

Descripción Método para descargar los diferentes archivos relacionados con los documentos de venta (PDF, XML, CDR) enviados al OSE/SUNAT
Respuesta Exitosa Código, Mensaje
Nombre del método DescargaArchivo
Cantidad de Campos: 4
Campo Descripción Tipo|Longitud Formato
<tem:usuario> Usuario de Integración Emitido por el Sistema
<tem:clave> Contraseña de Integración Emitido por el Sistema
<tem:documento> Tipo, serie y correlativo de documento a dar de baja AN|...16 TT-XZZZ-NNNNNNNN

Donde TT hace referencia al tipo de documento según catálogo N° 01
X hace referencia al tipo de documento:
F: Factura o notas asociadas
B: Boletas o notas asociadas
ZZZ hace referencia a la serie
NNNNNNNN hace referencia al correlativo

<tem:tipoArchivo> Tipo de archivo a descargar AN|3 PDF: Para descargar el pdf (representación impresa)

XML: Para descargar el xml (documento electrónico)
CDR: Para descargar la Constancia de Recepción de OSE/SUNAT

EstatusDocumento

Descripción Método para consultar estatus de documentos (factura, boleta de venta, nota de crédito y nota de débito) en el servicio The Factory HKA, para verificar si ya se envió a OSE/Sunat
Respuesta Exitosa Código, Mensaje
Nombre del método EstatusDocumento
Cantidad de Campos: 3
Campo Descripción Tipo|Longitud Formato
<tem:usuario> Usuario de Integración Emitido por el Sistema
<tem:clave> Contraseña de Integración Emitido por el Sistema
<tem:documento> RUC,Tipo, serie y correlativo de documento a consultar AN|...16 RUC-TT-XZZZ-NNNNNNNN

Donde TT hace referencia al tipo de documento según catálogo N° 01
X hace referencia al tipo de documento:
ZZZ hace referencia a la serie
NNNNNNNN hace referencia al correlativo


FoliosRestantes

Descripción Método para consultarla cantidad de folios restantes para el usuario
Respuesta Exitosa Código, Mensaje
Nombre del método FoliosRestantes
Cantidad de Campos: 3
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

Reversión

Descripción Método para anular un comprobante de retención o percepción
Respuesta Exitosa Código, Mensaje
Nombre del método Reversion
Cantidad de Campos: 4
Campo Descripción Tipo|Longitud Formato
<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
<tem:documento> Tipo, serie y correlativo de documento a revertir AN|...16 TT-XZZZ-NNNNNNNN

Donde TT hace referencia al tipo de documento según catálogo N° 01
X hace referencia al tipo de documento:
R: Retenciones
P: Percepciones
ZZZ hace referencia a la serie
NNNNNNNN hace referencia al correlativo

<tem:motivo> Motivo de la anulación del documento AN|...100

ValidaAcceso

Descripción Método para validar las credenciales de acceso
Respuesta Exitosa Código, Mensaje
Nombre del método ValidaAcceso
Cantidad de Campos: 3
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

GuiasRemision

Artículo principal: Web Service SOAP - Método GuiasRemision

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

  • Guía Remisión Electrónicas UBL 2.0
  • Guía Remisión Electrónicas UBL 1.0
Descripción Método para enviar documentos (Guías de Remisión 1.0 - 2.0) a OSE/SUNAT
Respuesta Exitosa Código de aceptación | Mensaje de aceptación | Serie - correlativo del documento y XML timbrado

CancelarListado

Descripción Método para cancelar un listado enviado.
Respuesta Exitosa Código, Mensaje
Nombre del método CancelarListado
Cantidad de Campos: 4
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
<tem:tipoCancelar> Tipo de listado a cancelar

Descripción Método de carga del logo de la empresa que se usará para generar electrónicamente las representaciones de documentos y comprobantes consignados a OSE/SUNAT.
Respuesta Exitosa Código, Mensaje
Nombre del método Logo
Cantidad de Campos: 5
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
<tem:extension> Extensión de la imagen (jpg, png, ...)
<tem:logo> logo

ListadoSerie

Descripción Permite realizar una petición para realizar las siguientes acciones por el tipo en las series asociadas a la empresa.
Respuesta Exitosa Código (devuelve 0 si es exitoso), Mensaje
Nombre del método ListadoSerie
Cantidad de Campos: 9
Campo Descripción Tipo|Longitud
<tem:ruc> RUC del emisor N|11
<tem:usuario> Usuario de Integración
<tem:clave> Clave de Integración
<tem:tipo> Tipo de acción a realizar Tipo 1: Te permite crear una serie

Tipo 2: Busca todas las series que posee la empresa.

Tipo 3: Actualiza la serie por nomenclatura de la serie

Tipo 4: Elimina la serie por nomenclatura de la serie



Campo Descripción Tipo|Longitud Formato
<per:folio_actual> Folio Actual de la Serie N|8
<per:folio_inicial> Folio Inicial de la Serie N|8
<per:serie> Nomenclatura de la Serie AN|4
<per:tipo_asignacion> Tipo de Asignación Manual o Automático A|1 Automático : A
Manual : M
<per:tipo_documento> Tipo de Documento asociado a la Serie N|2 Catálogo N°01

ListadoSucursal

Descripción Permite realizar una petición para realizar las siguientes acciones por el tipo en las sucursales asociadas a la empresa.
Respuesta Exitosa Código (devuelve 0 si es exitoso), Mensaje
Nombre del método ListadoSucursal
Cantidad de Campos: 4 -11
Campo Descripción Tipo|Longitud
<tem:ruc> RUC del emisor N|11
<tem:token> Token de acceso
<tem:serial> Serial del dispositivo
<tem:tipo> Tipo de acción a realizar Tipo 1: te permite crear una sucursal

Tipo 2: busca todas las sucursales asociadas a la empresa.

Tipo 3: Actualiza la sucursal por código.

Tipo 4: Borra la sucursal por código.

Datos Sucursal (Objeto / Listado)

Campo Descripción Tipo|Longitud
<tem:codigo> código de la sucursal string
<tem:descripcion> Descripción de la sucursal
<tem:direccion> Dirección de la sucursal
<tem:pais> Siglas del país Ejemplo: PE
<tem:telefono> Teléfonos de la sucursal
<tem:tipoEstablecimiento> Tipo de establecimiento
<tem:ubigeo> Codigo ubigeo de la ubicación de la sucursal

ListadoProductos

Descripción Permite realizar el listado , creación , actualización y eliminación de los distintos productos.
Respuesta Exitosa Código (devuelve 0 si es exitoso), Mensaje
Nombre del método ListadoProductos
Cantidad de Campos: 11
Campo Descripción Tipo|Longitud
<tem:ruc> RUC del emisor N|11
<tem:usuario> Usuario de Integración
<tem:clave> Clave de Integración
<tem:tipo> Tipo de acción a realizar Tipo 1: Te permite crear un producto

Tipo 2: Busca todos los productos que posee la empresa.

Tipo 3: Actualiza el producto por códigoUser

Tipo 4: Elimina el producto por códigoUser


Campo Descripción Tipo|Longitud Formato
<per:codigoGs1> Código GS1 del Producto. N|13
<per:codigoSunat> Código Sunat del Producto. N|8
<per:codigoUser> Código del Producto que asigna el Usuario internamente. AN|30
<per:descripcion> Descripción del Producto AN|500
<per:impuesto> Código de Tipo de Afectación del IGV N|4 Catálogo N°07
<per:unidad> Unidad de Medida del Producto AN|3
<per:valorUnitario> Valor Unitario del Producto 12,10

ListadoClientes

Descripción Permite realizar una petición para realizar las siguientes acciones por el tipo en los clientes asociados a la empresa.
Respuesta Exitosa Código (devuelve 0 si es exitoso), Mensaje
Nombre del método ListadoClientes
Cantidad de Campos: 9
Campo Descripción Tipo|Longitud
<tem:ruc> RUC del emisor N|11
<tem:usuario> Usuario de Integración
<tem:clave> Clave de Integración
<tem:tipo> Tipo de acción a realizar Tipo 1: Te permite crear un cliente

Tipo 2: Busca todos los clientes que posee la empresa.

Tipo 3: Actualiza la información del cliente por RUC

Tipo 4: Elimina la información del cliente por RUC



Campo Descripción Tipo|Longitud Formato
<per:direccion> Dirección AN|200
<per:email> Correo Electrónico del Cliente AN|200
<per:enviarEmail> Activar Notificaciones Via Correo Electrónico A|2 SI o NO
<per:numDocumento> Número de Documento del Cliente AN|15
<per:pais> País del Cliente A|2 Catálogo N°04
<per:razonSocial> Razón Social del Cliente AN|100
<per:telefono> Número de Telefono del Cliente N|15
<per:tipoDocumento> Tipo de Documento del Cliente N|2 Catálogo N°06
<per:ubigeo> Ubigeo de la Dirección del Cliente N|2



EnvioCorreo

Descripción Permite enviar via correo electrónico los archivos XML,PDF y CDR
Respuesta Exitosa Código (devuelve 0 si es exitoso), Mensaje
Nombre del método EnvioCorreo
Cantidad de Campos: 11
Campo Descripción Tipo|Longitud Formato
<tem:ruc> RUC del emisor N|11
<tem:usuario> Usuario de Integración
<tem:clave> Clave de Integración
<tem:numeracion> Numeración del Documento a Enviar AN|13 ZZZZ-NNNNNNNN, donde:

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

<tem:tipo> Tipo de Documento N|2 Catálogo N° 06
<tem:destinatarios> Correo electronico del destinatario. Debe ser una dirección válida para el envío correcto del documento electrónico.

Para enviar varios correos, deben separarse con el caracter , (coma) o ; (punto y coma)

AN|2000

EstatusCorreo

Descripción Permite realizar una petición para obtener información sobre el historial de envios del documento consultado.
Respuesta Exitosa Código (devuelve 0 si es exitoso), Mensaje
Nombre del método EstatusCorreo
Cantidad de Campos: 3
Campo Descripción Tipo|Longitud Formato
<tem:usuario> Usuario de Integración
<tem:clave> Clave de Integración
<tem:documento> Número de Documento a Consultar AN|28 RUC-TipoDeDocumento-Serie-Correlativo


DescargarListado

Descripción Permite Descargar los Listados
Respuesta Exitosa Código (devuelve 0 si es exitoso), Mensaje
Nombre del método DescargarListado
Cantidad de Campos: 5
Campo Descripción Tipo|Longitud Formato
<tem:ruc> RUC del emisor N|11
<tem:usuario> Usuario de Integración
<tem:clave> Clave de Integración
<tem:lote> Numeración del lote
<tem:ticket> numero del ticket (respuesta de GeneraListado)

Retención/Percepción

Descripción Permite enviar via correo electrónico los archivos XML,PDF y CDR
Respuesta Exitosa Código (devuelve 0 si es exitoso), Mensaje
Nombre del método RetencionPercepcion
Cantidad de Campos: 5

Artículo principal: Web Service SOAP - Método RetenciónPercción

Campo Descripción Tipo|Longitud Formato
<tem:ruc> RUC del emisor N|11
<tem:usuario> Usuario de Integración AN
<tem:clave> Clave de Integración AN
<tem:layout> Archivo TXT en base64 AN

Estatus

Descripción Permite realizar una petición para obtener el estado de las credenciales de integración
Respuesta Exitosa Código (devuelve 0 si es exitoso), Mensaje
Nombre del método Estatus
Cantidad de Campos: 4
Campo Descripción Tipo|Longitud Formato
<tem:ruc> Ruc de la empresa 11
<tem:usuario> Usuario de Integración AN
<tem:clave> Clave de Integración AN
<tem:tipoaplicacion> Tipo de aplicación que se consulta AN|1 I
Obtenido de «http://felwiki.thefactoryhka.com.pe/index.php?title=Integración_Directa_-_Web_Service_SOAP&oldid=1321»