Facturacion Electronica de Peru - Contribuciones del usuario [es]

Integración Directa - Web Service SOAP

2024-06-20T17:03:41Z

Ichirinos:

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


[[File:Modelo_Online.png|thumb|Proceso del Modelo Online|500px]]

==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 [https://cpe.sunat.gob.pe/node/88 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 [http://www.ejemplo.com 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 https://demoint.thefactoryhka.com.pe/Service.svc].

===Enviar===

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

{| class="wikitable" style="margin: auto;"
! style="text-align:left;" style="color:red"| Descripción
! ''Método para enviar documentos (factura, boleta de venta, nota de crédito y nota de débito) a OSE/SUNAT''
|-
! style="text-align:left;" style="color:red"| Respuesta Exitosa
! ''Código de aceptación <nowiki>|</nowiki> Mensaje de aceptación <nowiki>|</nowiki> Serie - correlativo del documento y XML timbrado''
|}

===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''
|}

====Parámetros de Entrada====
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | CargarCertificado
|-
!Cantidad de Campos:
!style="text-align:left;"|5
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
|-
| style="color: blue; text-align:center"| <tem:ruc>
| RUC del emisor
| style="text-align:center;"| N<nowiki>|</nowiki>11
|-
| style="color: blue; text-align:center" | <tem:usuario>
| Usuario de Integración Emitido por el Sistema
| style="text-align:center;"|
|-
| style="color: blue; text-align:center" | <tem:clave>
| Contraseña de Integración Emitido por el Sistema
| style="text-align:center;"|
|-
| style="color: blue; text-align:center" | <tem:certificadoBase64>
| Certificado autorizado, cifrado en base 64
| style="text-align:center;"|
|-
| style="color: blue; text-align:center" | <tem:certificadoClaveBase64>
| Clave del certificado, cifrada en base 64
| style="text-align:center;"|
|-
|}

===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''
|}

====Parámetros de Entrada====
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | ComunicacionBaja
|-
!Cantidad de Campos:
!style="text-align:left;"|5
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Formato
|-
| style="color: blue; text-align:center"| <tem:ruc>
| RUC del emisor
| style="text-align:center;"| N<nowiki>|</nowiki>11
|
|-
| style="color: blue; text-align:center" | <tem:usuario>
| Usuario de Integración Emitido por el Sistema
| style="text-align:center;"|
|
|-
| style="color: blue; text-align:center" | <tem:clave>
| Contraseña de Integración Emitido por el Sistema
| style="text-align:center;"|
|-
| style="color: blue; text-align:center" | <tem:documento>
| Tipo, serie y correlativo de documento a dar de baja
| style="text-align:center;"| AN<nowiki>|</nowiki>...16
| style="text-align:center;"| 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
|-
| style="color: blue; text-align:center" | <tem:motivo>
| Motivo de la anulación del documento
| style="text-align:center;"| AN<nowiki>|</nowiki>...100
|-
|}

===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''
|}

====Parámetros de Entrada====
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | DescargaArchivo
|-
!Cantidad de Campos:
!style="text-align:left;"|4
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Formato
|-
| style="color: blue; text-align:center" | <tem:usuario>
| Usuario de Integración Emitido por el Sistema
| style="text-align:center;"|
|
|-
| style="color: blue; text-align:center" | <tem:clave>
| Contraseña de Integración Emitido por el Sistema
| style="text-align:center;"|
|-
| style="color: blue; text-align:center" | <tem:documento>
| Tipo, serie y correlativo de documento a dar de baja
| style="text-align:center;"| AN<nowiki>|</nowiki>...16
| style="text-align:center;"| 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
|-
| style="color: blue; text-align:center"| <tem:tipoArchivo>
| Tipo de archivo a descargar
| style="text-align:center;"| AN<nowiki>|</nowiki>3
| style="text-align:center;"| 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===
{| class="wikitable" style="margin: auto;"
! style="text-align:left;" style="color:red"| 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''
|-
! style="text-align:left;" style="color:red"| Respuesta Exitosa
! ''Código, Mensaje''
|}

====Parámetros de Entrada====
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | EstatusDocumento
|-
!Cantidad de Campos:
!style="text-align:left;"|3
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Formato
|-
| style="color: blue; text-align:center" | <tem:usuario>
| Usuario de Integración Emitido por el Sistema
| style="text-align:center;"|
|
|-
| style="color: blue; text-align:center" | <tem:clave>
| Contraseña de Integración Emitido por el Sistema
| style="text-align:center;"|
|-
| style="color: blue; text-align:center" | <tem:documento>
|RUC,Tipo, serie y correlativo de documento a consultar
| style="text-align:center;"| AN<nowiki>|</nowiki>...16
| style="text-align:center;"| 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===
{| 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''
|-
! style="text-align:left;" style="color:red"| Respuesta Exitosa
! ''Código, Mensaje''
|}

====Parámetros de Entrada====
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | FoliosRestantes
|-
!Cantidad de Campos:
!style="text-align:left;"|3
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
|-
| style="color: blue; text-align:center" | <tem:ruc>
| RUC del emisor
| style="text-align:center;"| N<nowiki>|</nowiki>11
|-
| style="color: blue; text-align:center" | <tem:usuario>
| Usuario de Integración Emitido por el Sistema
| style="text-align:center;"|
|-
| style="color: blue; text-align:center" | <tem:clave>
| Contraseña de Integración Emitido por el Sistema
| style="text-align:center;"|
|-
|}

===Reversion===
{| class="wikitable" style="margin: auto;"
! style="text-align:left;" style="color:red"| Descripción
! ''Método para anular un comprobante de retención o percepción''
|-
! style="text-align:left;" style="color:red"| Respuesta Exitosa
! ''Código, Mensaje''
|}

====Parámetros de Entrada====
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | Reversion
|-
!Cantidad de Campos:
!style="text-align:left;"|4
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Formato
|-
| style="color: blue; text-align:center"| <tem:ruc>
| RUC del emisor
| style="text-align:center;"| N<nowiki>|</nowiki>11
|
|-
| style="color: blue; text-align:center" | <tem:usuario>
| Usuario de Integración Emitido por el Sistema
| style="text-align:center;"|
|
|-
| style="color: blue; text-align:center" | <tem:clave>
| Contraseña de Integración Emitido por el Sistema
| style="text-align:center;"|
|-
| style="color: blue; text-align:center" | <tem:documento>
| Tipo, serie y correlativo de documento a revertir
| style="text-align:center;"| AN<nowiki>|</nowiki>...16
| style="text-align:center;"| 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
|-
| style="color: blue; text-align:center" | <tem:motivo>
| Motivo de la anulación del documento
| style="text-align:center;"| AN<nowiki>|</nowiki>...100
|-
|}

===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''
|}

====Parámetros de Entrada====
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | ValidaAcceso
|-
!Cantidad de Campos:
!style="text-align:left;"|3
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
|-
| style="color: blue; text-align:center" | <tem:ruc>
| RUC del emisor
| style="text-align:center;"| N<nowiki>|</nowiki>11
|-
| style="color: blue; text-align:center" | <tem:usuario>
| Usuario de Integración Emitido por el Sistema
| style="text-align:center;"|
|-
| style="color: blue; text-align:center" | <tem:clave>
| Contraseña de Integración Emitido por el Sistema
| style="text-align:center;"|
|-
|}

=== 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'''
{| 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''
|}

=== 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''
|}

====Parámetros de Entrada====
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | CancelarListado
|-
!Cantidad de Campos:
! style="text-align:left;" |4
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
|-
| style="color: blue; text-align:center"  | <tem:ruc>
|RUC del emisor
| style="text-align:center;"  | N<nowiki>|</nowiki>11
|-
| style="color: blue; text-align:center"  | <tem:usuario>
|Usuario de Integración Emitido por el Sistema
| style="text-align:center;"  |
|-
| style="color: blue; text-align:center"  | <tem:clave>
|Contraseña de Integración Emitido por el Sistema
| style="text-align:center;"  |
|-
| style="color: blue; text-align:center"  | <tem:tipoCancelar>
|Tipo de listado a cancelar
| style="text-align:center;"  |
|-
|}

=== Logo ===
{| class="wikitable" style="margin: auto;"
! 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.''
|-
! style="color:red" | Respuesta Exitosa
! ''Código, Mensaje''
|}

====Parámetros de Entrada====
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | Logo
|-
!Cantidad de Campos:
! style="text-align:left;" |5
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
|-
| style="color: blue; text-align:center"  | <tem:ruc>
|RUC del emisor
| style="text-align:center;"  | N<nowiki>|</nowiki>11
|-
| style="color: blue; text-align:center"  | <tem:usuario>
|Usuario de Integración Emitido por el Sistema
| style="text-align:center;"  |
|-
| style="color: blue; text-align:center"  | <tem:clave>
|Contraseña de Integración Emitido por el Sistema
| style="text-align:center;"  |
|-
| style="color: blue; text-align:center"  | <tem:extension>
|Extensión de la imagen (jpg, png, ...)
| style="text-align:center;"  |
|-
| style="color: blue; text-align:center"  | <tem:logo>
|logo
| style="text-align:center;"  |
|-
|}

=== 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''
|}

====Parámetros de Entrada====
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | ListadoSucursal
|-
!Cantidad de Campos:
! style="text-align:left;" |4 -11
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
|-
| style="color: blue; text-align:center"  | <tem:ruc>
|RUC del emisor
| style="text-align:center;"  | N<nowiki>|</nowiki>11
|-
| style="color: blue; text-align:center"  | <tem:token>
|Token de acceso
| style="text-align:center;"  |
|-
| style="color: blue; text-align:center"  | <tem:serial>
|Serial del dispositivo
| style="text-align:center;"  |
|-
| style="color: blue; text-align:center"  | <tem:tipo>
|Tipo de acción a realizar
| style="text-align:center;"  |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)
{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
|-
| style="color: blue; text-align:center"  | <tem:codigo>
|código de la sucursal
| style="text-align:center;"  | string
|-
| style="color: blue; text-align:center"  | <tem:descripcion>
|Descripción de la sucursal
| style="text-align:center;"  |
|-
| style="color: blue; text-align:center"  | <tem:direccion>
|Dirección de la sucursal
| style="text-align:center;"  |
|-
| style="color: blue; text-align:center"  | <tem:pais>
|Siglas del país Ejemplo: PE
| style="text-align:center;"  |
|-
| style="color: blue; text-align:center"  | <tem:telefono>
|Teléfonos de la sucursal
| style="text-align:center;"  |
|-
|<tem:tipoEstablecimiento>
|Tipo de establecimiento
|
|-
|<tem:ubigeo>
|Codigo ubigeo de la ubicación de la sucursal
|
|}

=== 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''
|}

====Parámetros de Entrada====
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | ListadoProductos
|-
!Cantidad de Campos:
! style="text-align:left;" |11
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
|-
| style="color: blue; text-align:center"  | <tem:ruc>
|RUC del emisor
| style="text-align:center;"  | N<nowiki>|</nowiki>11
|-
| style="color: blue; text-align:center"  | <tem:usuario>
|Usuario de Integración
| style="text-align:center;"  |
|-
| style="color: blue; text-align:center"  | <tem:clave>
|Clave de Integración
| style="text-align:center;"  |
|-
| style="color: blue; text-align:center"  | <tem:tipo>
|Tipo de acción a realizar
| style="text-align:center;"  |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

|-
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Formato
|-
| style="color: blue; text-align:center"  | <per:codigoGs1>
|Código GS1 del Producto.
| style="text-align:center;"  | N<nowiki>|</nowiki>13
|
|-
| style="color: blue; text-align:center"  | <per:codigoSunat>
|Código Sunat del Producto.
| style="text-align:center;"  | N<nowiki>|</nowiki>8
|
|-
| style="color: blue; text-align:center"  | <per:codigoUser>
|Código del Producto que asigna el Usuario internamente.
| style="text-align:center;"  | AN<nowiki>|</nowiki>30
|
|-
| style="color: blue; text-align:center"  | <per:descripcion>
|Descripción del Producto
| style="text-align:center;"  | AN<nowiki>|</nowiki>500
|
|-
| style="color: blue; text-align:center"  | <per:impuesto>
|Código de Tipo de Afectación del IGV
| style="text-align:center;"  | N<nowiki>|</nowiki>4
| Catálogo N°07
|-
| style="color: blue; text-align:center"  | <per:unidad>
|Unidad de Medida del Producto
| style="text-align:center;"  |AN<nowiki>|</nowiki>3
|
|-
| style="color: blue; text-align:center"  | <per:valorUnitario>
|Valor Unitario del Producto
| style="text-align:center;"  |12,10
|
|-
|}

=== 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''
|}

====Parámetros de Entrada====
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | EnvioCorreo
|-
!Cantidad de Campos:
! style="text-align:left;" |11
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Formato
|-
| style="color: blue; text-align:center"  | <tem:ruc>
|RUC del emisor
| style="text-align:center;"  | N<nowiki>|</nowiki>11
|
|-
| style="color: blue; text-align:center"  | <tem:usuario>
|Usuario de Integración
| style="text-align:center;"  |
|
|-
| style="color: blue; text-align:center"  | <tem:clave>
|Clave de Integración
| style="text-align:center;"  |
|
|-
| style="color: blue; text-align:center"  | <tem:numeracion>
|Numeración del Documento a Enviar
| style="text-align:center;"  |AN<nowiki>|</nowiki>13
| style="text-align:center;"  |ZZZZ-NNNNNNNN, donde: 
ZZZZ corresponde a la serie 
NNNNNNNN al número de documento
|-
| style="color: blue; text-align:center"  | <tem:tipo>
|Tipo de Documento
| style="text-align:center;"  |N<nowiki>|</nowiki>2
| style="text-align:center;"  |Catálogo N° 06
|-
| style="color: blue; text-align:center"  | <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)
| style="text-align:center;"  |AN<nowiki>|</nowiki>2000
|
|-
|}

=== DescargarListado ===
{| 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''
|}

====Parámetros de Entrada====
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | DescargarListado
|-
!Cantidad de Campos:
! style="text-align:left;" |5
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Formato
|-
| style="color: blue; text-align:center"  | <tem:ruc>
|RUC del emisor
| style="text-align:center;"  | N<nowiki>|</nowiki>11
|
|-
| style="color: blue; text-align:center"  | <tem:usuario>
|Usuario de Integración
| style="text-align:center;"  |
|
|-
| style="color: blue; text-align:center"  | <tem:clave>
|Clave de Integración
| style="text-align:center;"  |
|
|-
| style="color: blue; text-align:center"  | <tem:lote>
|Numeración del lote
| style="text-align:center;"  |
| style="text-align:center;"  |
|-
| style="color: blue; text-align:center"  | <tem:ticket>
|numero del ticket (respuesta de GeneraListado)
| style="text-align:center;"  |
| style="text-align:center;"  |
|-
|}

Integración Directa - Web Service SOAP

2024-05-17T21:26:47Z

Ichirinos: /* Parámetros de Entrada */

Integración Directa - Web Service SOAP

2024-05-17T21:15:59Z

Ichirinos: /* CancelarListado */ listado sucursal

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


[[File:Modelo_Online.png|thumb|Proceso del Modelo Online|500px]]

==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 [https://cpe.sunat.gob.pe/node/88 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 [http://www.ejemplo.com 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 https://demoint.thefactoryhka.com.pe/Service.svc].

===Enviar===

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

{| class="wikitable" style="margin: auto;"
! style="text-align:left;" style="color:red"| Descripción
! ''Método para enviar documentos (factura, boleta de venta, nota de crédito y nota de débito) a OSE/SUNAT''
|-
! style="text-align:left;" style="color:red"| Respuesta Exitosa
! ''Código de aceptación <nowiki>|</nowiki> Mensaje de aceptación <nowiki>|</nowiki> Serie - correlativo del documento y XML timbrado''
|}

===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''
|}

====Parámetros de Entrada====
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | CargarCertificado
|-
!Cantidad de Campos:
!style="text-align:left;"|5
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
|-
| style="color: blue; text-align:center"| <tem:ruc>
| RUC del emisor
| style="text-align:center;"| N<nowiki>|</nowiki>11
|-
| style="color: blue; text-align:center" | <tem:usuario>
| Usuario de Integración Emitido por el Sistema
| style="text-align:center;"|
|-
| style="color: blue; text-align:center" | <tem:clave>
| Contraseña de Integración Emitido por el Sistema
| style="text-align:center;"|
|-
| style="color: blue; text-align:center" | <tem:certificadoBase64>
| Certificado autorizado, cifrado en base 64
| style="text-align:center;"|
|-
| style="color: blue; text-align:center" | <tem:certificadoClaveBase64>
| Clave del certificado, cifrada en base 64
| style="text-align:center;"|
|-
|}

===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''
|}

====Parámetros de Entrada====
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | ComunicacionBaja
|-
!Cantidad de Campos:
!style="text-align:left;"|5
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Formato
|-
| style="color: blue; text-align:center"| <tem:ruc>
| RUC del emisor
| style="text-align:center;"| N<nowiki>|</nowiki>11
|
|-
| style="color: blue; text-align:center" | <tem:usuario>
| Usuario de Integración Emitido por el Sistema
| style="text-align:center;"|
|
|-
| style="color: blue; text-align:center" | <tem:clave>
| Contraseña de Integración Emitido por el Sistema
| style="text-align:center;"|
|-
| style="color: blue; text-align:center" | <tem:documento>
| Tipo, serie y correlativo de documento a dar de baja
| style="text-align:center;"| AN<nowiki>|</nowiki>...16
| style="text-align:center;"| 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
|-
| style="color: blue; text-align:center" | <tem:motivo>
| Motivo de la anulación del documento
| style="text-align:center;"| AN<nowiki>|</nowiki>...100
|-
|}

===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''
|}

====Parámetros de Entrada====
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | DescargaArchivo
|-
!Cantidad de Campos:
!style="text-align:left;"|4
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Formato
|-
| style="color: blue; text-align:center" | <tem:usuario>
| Usuario de Integración Emitido por el Sistema
| style="text-align:center;"|
|
|-
| style="color: blue; text-align:center" | <tem:clave>
| Contraseña de Integración Emitido por el Sistema
| style="text-align:center;"|
|-
| style="color: blue; text-align:center" | <tem:documento>
| Tipo, serie y correlativo de documento a dar de baja
| style="text-align:center;"| AN<nowiki>|</nowiki>...16
| style="text-align:center;"| 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
|-
| style="color: blue; text-align:center"| <tem:tipoArchivo>
| Tipo de archivo a descargar
| style="text-align:center;"| AN<nowiki>|</nowiki>3
| style="text-align:center;"| 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===
{| class="wikitable" style="margin: auto;"
! style="text-align:left;" style="color:red"| 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''
|-
! style="text-align:left;" style="color:red"| Respuesta Exitosa
! ''Código, Mensaje''
|}

====Parámetros de Entrada====
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | EstatusDocumento
|-
!Cantidad de Campos:
!style="text-align:left;"|3
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Formato
|-
| style="color: blue; text-align:center" | <tem:usuario>
| Usuario de Integración Emitido por el Sistema
| style="text-align:center;"|
|
|-
| style="color: blue; text-align:center" | <tem:clave>
| Contraseña de Integración Emitido por el Sistema
| style="text-align:center;"|
|-
| style="color: blue; text-align:center" | <tem:documento>
|RUC,Tipo, serie y correlativo de documento a consultar
| style="text-align:center;"| AN<nowiki>|</nowiki>...16
| style="text-align:center;"| 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===
{| 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''
|-
! style="text-align:left;" style="color:red"| Respuesta Exitosa
! ''Código, Mensaje''
|}

====Parámetros de Entrada====
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | FoliosRestantes
|-
!Cantidad de Campos:
!style="text-align:left;"|3
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
|-
| style="color: blue; text-align:center" | <tem:ruc>
| RUC del emisor
| style="text-align:center;"| N<nowiki>|</nowiki>11
|-
| style="color: blue; text-align:center" | <tem:usuario>
| Usuario de Integración Emitido por el Sistema
| style="text-align:center;"|
|-
| style="color: blue; text-align:center" | <tem:clave>
| Contraseña de Integración Emitido por el Sistema
| style="text-align:center;"|
|-
|}

===Reversion===
{| class="wikitable" style="margin: auto;"
! style="text-align:left;" style="color:red"| Descripción
! ''Método para anular un comprobante de retención o percepción''
|-
! style="text-align:left;" style="color:red"| Respuesta Exitosa
! ''Código, Mensaje''
|}

====Parámetros de Entrada====
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | Reversion
|-
!Cantidad de Campos:
!style="text-align:left;"|4
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Formato
|-
| style="color: blue; text-align:center"| <tem:ruc>
| RUC del emisor
| style="text-align:center;"| N<nowiki>|</nowiki>11
|
|-
| style="color: blue; text-align:center" | <tem:usuario>
| Usuario de Integración Emitido por el Sistema
| style="text-align:center;"|
|
|-
| style="color: blue; text-align:center" | <tem:clave>
| Contraseña de Integración Emitido por el Sistema
| style="text-align:center;"|
|-
| style="color: blue; text-align:center" | <tem:documento>
| Tipo, serie y correlativo de documento a revertir
| style="text-align:center;"| AN<nowiki>|</nowiki>...16
| style="text-align:center;"| 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
|-
| style="color: blue; text-align:center" | <tem:motivo>
| Motivo de la anulación del documento
| style="text-align:center;"| AN<nowiki>|</nowiki>...100
|-
|}

===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''
|}

====Parámetros de Entrada====
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | ValidaAcceso
|-
!Cantidad de Campos:
!style="text-align:left;"|3
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
|-
| style="color: blue; text-align:center" | <tem:ruc>
| RUC del emisor
| style="text-align:center;"| N<nowiki>|</nowiki>11
|-
| style="color: blue; text-align:center" | <tem:usuario>
| Usuario de Integración Emitido por el Sistema
| style="text-align:center;"|
|-
| style="color: blue; text-align:center" | <tem:clave>
| Contraseña de Integración Emitido por el Sistema
| style="text-align:center;"|
|-
|}

=== 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'''
{| 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''
|}

=== 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''
|}

====Parámetros de Entrada====
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | CancelarListado
|-
!Cantidad de Campos:
! style="text-align:left;" |4
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
|-
| style="color: blue; text-align:center"  | <tem:ruc>
|RUC del emisor
| style="text-align:center;"  | N<nowiki>|</nowiki>11
|-
| style="color: blue; text-align:center"  | <tem:usuario>
|Usuario de Integración Emitido por el Sistema
| style="text-align:center;"  |
|-
| style="color: blue; text-align:center"  | <tem:clave>
|Contraseña de Integración Emitido por el Sistema
| style="text-align:center;"  |
|-
| style="color: blue; text-align:center"  | <tem:tipoCancelar>
|Tipo de listado a cancelar
| style="text-align:center;"  |
|-
|}

=== Logo ===
{| class="wikitable" style="margin: auto;"
! 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.''
|-
! style="color:red" | Respuesta Exitosa
! ''Código, Mensaje''
|}

====Parámetros de Entrada====
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | Logo
|-
!Cantidad de Campos:
! style="text-align:left;" |5
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
|-
| style="color: blue; text-align:center"  | <tem:ruc>
|RUC del emisor
| style="text-align:center;"  | N<nowiki>|</nowiki>11
|-
| style="color: blue; text-align:center"  | <tem:usuario>
|Usuario de Integración Emitido por el Sistema
| style="text-align:center;"  |
|-
| style="color: blue; text-align:center"  | <tem:clave>
|Contraseña de Integración Emitido por el Sistema
| style="text-align:center;"  |
|-
| style="color: blue; text-align:center"  | <tem:extension>
|Extensión de la imagen (jpg, png, ...)
| style="text-align:center;"  |
|-
| style="color: blue; text-align:center"  | <tem:logo>
|logo
| style="text-align:center;"  |
|-
|}

=== 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''
|}

====Parámetros de Entrada====
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | ListadoSucursal
|-
!Cantidad de Campos:
! style="text-align:left;" |4 -11
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
|-
| style="color: blue; text-align:center"  | <tem:ruc>
|RUC del emisor
| style="text-align:center;"  | N<nowiki>|</nowiki>11
|-
| style="color: blue; text-align:center"  | <tem:token>
|Token de acceso
| style="text-align:center;"  |
|-
| style="color: blue; text-align:center"  | <tem:serial>
|Serial del dispositivo
| style="text-align:center;"  |
|-
| style="color: blue; text-align:center"  | <tem:tipo>
|Tipo de acción a realizar
| style="text-align:center;"  |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 (Object)
{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
|-
| style="color: blue; text-align:center"  | <tem:codigo>
|código de la sucursal
| style="text-align:center;"  | string
|-
| style="color: blue; text-align:center"  | <tem:descripcion>
|Descripción de la sucursal
| style="text-align:center;"  |
|-
| style="color: blue; text-align:center"  | <tem:direccion>
|Dirección de la sucursal
| style="text-align:center;"  |
|-
| style="color: blue; text-align:center"  | <tem:pais>
|Siglas del país Ejemplo: PE
| style="text-align:center;"  |
|-
| style="color: blue; text-align:center"  | <tem:telefono>
|Teléfonos de la sucursal
| style="text-align:center;"  |
|-
|<tem:tipoEstablecimiento>
|Tipo de establecimiento
|
|-
|<tem:ubigeo>
|Codigo ubigeo de la ubicación de la sucursal
|
|}

Integración Directa - Web Service SOAP

2024-04-10T22:38:10Z

Ichirinos:

Integración Directa - Web Service SOAP

2024-04-10T22:04:34Z

Ichirinos: