Facturacion Electronica de Peru - Contribuciones del usuario [es]

Integración Directa - Web Service REST

2025-01-24T16:48:47Z

Peraltaa: /* Parámetros de Entrada */

Integración Directa - Web Service REST

2025-01-24T16:48:15Z

Peraltaa: /* DescargaArchivo */

Integración Directa - Web Service SOAP

2024-08-22T17:51:26Z

Peraltaa:

==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;"  |
|-
|}

=== ListadoSerie===
{| 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 series 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" | ListadoSerie
|-
!Cantidad de Campos:
! style="text-align:left;" |9
|}

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

|-
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Formato
|-
| style="color: blue; text-align:center"  | <per:folio_actual>
|Folio Actual de la Serie
| style="text-align:center;"  | N<nowiki>|</nowiki>8
|
|-
| style="color: blue; text-align:center"  | <per:folio_inicial>
|Folio Inicial de la Serie
| style="text-align:center;"  | N<nowiki>|</nowiki>8
|
|-
| style="color: blue; text-align:center"  | <per:serie>
|Nomenclatura de la Serie
| style="text-align:center;"  | AN<nowiki>|</nowiki>4
|
|-
| style="color: blue; text-align:center"  | <per:tipo_asignacion>
|Tipo de Asignación Manual o Automático
| style="text-align:center;"  | A<nowiki>|</nowiki>1
|Automático : A Manual : M
|-
| style="color: blue; text-align:center"  | <per:tipo_documento>
|Tipo de Documento asociado a la Serie
| style="text-align:center;"  | N<nowiki>|</nowiki>2
| Catálogo N°01
|-
|}

=== 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;"  |
|-
| style="color: blue; text-align:center"  |<tem:tipoEstablecimiento>
|Tipo de establecimiento
|
|-
| style="color: blue; text-align:center"  |<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
|
|-
|}

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

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

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

|-
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Formato
|-
| style="color: blue; text-align:center"  | <per:direccion>
|Dirección
| style="text-align:center;"  | AN<nowiki>|</nowiki>200
|
|-
| style="color: blue; text-align:center"  | <per:email>
|Correo Electrónico del Cliente
| style="text-align:center;"  | AN<nowiki>|</nowiki>200
|
|-
| style="color: blue; text-align:center"  | <per:enviarEmail>
|Activar Notificaciones Via Correo Electrónico
| style="text-align:center;"  | A<nowiki>|</nowiki>2
|SI o NO
|-
| style="color: blue; text-align:center"  | <per:numDocumento>
|Número de Documento del Cliente
| style="text-align:center;"  | AN<nowiki>|</nowiki>15
|
|-
| style="color: blue; text-align:center"  | <per:pais>
|País del Cliente
| style="text-align:center;"  | A<nowiki>|</nowiki>2
|Catálogo N°04
|-
| style="color: blue; text-align:center"  | <per:razonSocial>
|Razón Social del Cliente
| style="text-align:center;"  | AN<nowiki>|</nowiki>100
|
|-
| style="color: blue; text-align:center"  | <per:telefono>
|Número de Telefono del Cliente
| style="text-align:center;"  | N<nowiki>|</nowiki>15
|
|-
| style="color: blue; text-align:center"  | <per:tipoDocumento>
|Tipo de Documento del Cliente
| style="text-align:center;"  | N<nowiki>|</nowiki>2
| Catálogo N°06
|-
| style="color: blue; text-align:center"  | <per:ubigeo>
|Ubigeo de la Dirección del Cliente
| style="text-align:center;"  | N<nowiki>|</nowiki>2
|
|-
|}

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

=== EstatusCorreo===
{| class="wikitable" style="margin: auto;"
! style="color:red" | Descripción
! ''Permite realizar una petición para obteber información sobre el historial de envios del documento consultado.''
|-
! 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" | EstatusCorreo
|-
!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
| 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:documento>
|Número de Documento a Consultar
| style="text-align:center;"  | AN<nowiki>|</nowiki>28
|RUC-TipoDeDocumento-Serie-Correlativo
|-

|}

=== 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-08-22T17:34:41Z

Peraltaa:

==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;"  |
|-
|}

=== ListadoSerie===
{| 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 series 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" | ListadoSerie
|-
!Cantidad de Campos:
! style="text-align:left;" |9
|}

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

|-
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Formato
|-
| style="color: blue; text-align:center"  | <per:folio_actual>
|Folio Actual de la Serie
| style="text-align:center;"  | N<nowiki>|</nowiki>8
|
|-
| style="color: blue; text-align:center"  | <per:folio_inicial>
|Folio Inicial de la Serie
| style="text-align:center;"  | N<nowiki>|</nowiki>8
|
|-
| style="color: blue; text-align:center"  | <per:serie>
|Nomenclatura de la Serie
| style="text-align:center;"  | AN<nowiki>|</nowiki>4
|
|-
| style="color: blue; text-align:center"  | <per:tipo_asignacion>
|Tipo de Asignación Manual o Automático
| style="text-align:center;"  | A<nowiki>|</nowiki>1
|Automático : A Manual : M
|-
| style="color: blue; text-align:center"  | <per:tipo_documento>
|Tipo de Documento asociado a la Serie
| style="text-align:center;"  | N<nowiki>|</nowiki>2
| Catálogo N°01
|-
|}

=== 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;"  |
|-
| style="color: blue; text-align:center"  |<tem:tipoEstablecimiento>
|Tipo de establecimiento
|
|-
| style="color: blue; text-align:center"  |<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
|
|-
|}

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

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

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

|-
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Formato
|-
| style="color: blue; text-align:center"  | <per:direccion>
|Dirección
| style="text-align:center;"  | AN<nowiki>|</nowiki>200
|
|-
| style="color: blue; text-align:center"  | <per:email>
|Correo Electrónico del Cliente
| style="text-align:center;"  | AN<nowiki>|</nowiki>200
|
|-
| style="color: blue; text-align:center"  | <per:enviarEmail>
|Activar Notificaciones Via Correo Electrónico
| style="text-align:center;"  | A<nowiki>|</nowiki>2
|SI o NO
|-
| style="color: blue; text-align:center"  | <per:numDocumento>
|Número de Documento del Cliente
| style="text-align:center;"  | AN<nowiki>|</nowiki>15
|
|-
| style="color: blue; text-align:center"  | <per:pais>
|País del Cliente
| style="text-align:center;"  | A<nowiki>|</nowiki>2
|Catálogo N°04
|-
| style="color: blue; text-align:center"  | <per:razonSocial>
|Razón Social del Cliente
| style="text-align:center;"  | AN<nowiki>|</nowiki>100
|
|-
| style="color: blue; text-align:center"  | <per:telefono>
|Número de Telefono del Cliente
| style="text-align:center;"  | N<nowiki>|</nowiki>15
|
|-
| style="color: blue; text-align:center"  | <per:tipoDocumento>
|Tipo de Documento del Cliente
| style="text-align:center;"  | N<nowiki>|</nowiki>2
| Catálogo N°06
|-
| style="color: blue; text-align:center"  | <per:ubigeo>
|Ubigeo de la Dirección del Cliente
| style="text-align:center;"  | N<nowiki>|</nowiki>2
|
|-
|}

=== 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-08-22T16:56:49Z

Peraltaa:

==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;"  |
|-
|}

=== ListadoSerie===
{| 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 series 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" | ListadoSerie
|-
!Cantidad de Campos:
! style="text-align:left;" |9
|}

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

|-
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Formato
|-
| style="color: blue; text-align:center"  | <per:folio_actual>
|Folio Actual de la Serie
| style="text-align:center;"  | N<nowiki>|</nowiki>8
|
|-
| style="color: blue; text-align:center"  | <per:folio_inicial>
|Folio Inicial de la Serie
| style="text-align:center;"  | N<nowiki>|</nowiki>8
|
|-
| style="color: blue; text-align:center"  | <per:serie>
|Nomenclatura de la Serie
| style="text-align:center;"  | AN<nowiki>|</nowiki>4
|
|-
| style="color: blue; text-align:center"  | <per:tipo_asignacion>
|Tipo de Asignación Manual o Automático
| style="text-align:center;"  | A<nowiki>|</nowiki>1
|Automático : A Manual : M
|-
| style="color: blue; text-align:center"  | <per:tipo_documento>
|Tipo de Documento asociado a la Serie
| style="text-align:center;"  | N<nowiki>|</nowiki>2
| Catálogo N°01
|-
|}

=== 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;"  |
|-
| style="color: blue; text-align:center"  |<tem:tipoEstablecimiento>
|Tipo de establecimiento
|
|-
| style="color: blue; text-align:center"  |<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-08-19T15:04:26Z

Peraltaa: /* Parámetros de Entrada */

==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;"  |
|-
| style="color: blue; text-align:center"  |<tem:tipoEstablecimiento>
|Tipo de establecimiento
|
|-
| style="color: blue; text-align:center"  |<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-29T17:10:57Z

Peraltaa: /* Parámetros de Entrada */

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

Integración Directa - Web Service SOAP

2024-05-29T17:10:18Z

Peraltaa: /* Parámetros de Entrada */

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

Integración Directa - Web Service SOAP

2024-05-29T17:09:50Z

Peraltaa: /* Parámetros de Entrada */

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

Integración Directa - Web Service SOAP

2024-05-29T17:05:16Z

Peraltaa:

==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
|
|-
| style="color: blue; text-align:center"  | <tem:tipo>
|Tipo de Documento
| style="text-align:center;"  |N<nowiki>|</nowiki>2
|
|-
| style="color: blue; text-align:center"  | <tem:destinatarios>
|Correo electronico del destinatario
| style="text-align:center;"  |AN<nowiki>|</nowiki>
|
|-
|}

Nota: Si desea enviar más de 1 destinatario debe dividirlo por punto y coma ";"

Integración Directa - Web Service SOAP

2024-05-29T16:46:40Z

Peraltaa: /* Parámetros de Entrada */

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

Integración Directa - Web Service SOAP

2024-05-29T16:45:39Z

Peraltaa: /* ListadoProductos */

==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;"  |A<nowiki>|</nowiki>3
|
|-
| style="color: blue; text-align:center"  | <per:valorUnitario>
|Valor Unitario del Producto
| style="text-align:center;"  |12,10
|
|-
|}

Integración Directa - Web Service SOAP

2024-05-29T16:39:53Z

Peraltaa:

==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
|-
| 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>
|Impuesto: 1000 - Gravada ::: 9996 - Gratuita
| style="text-align:center;"  | N<nowiki>|</nowiki>4
|-
| style="color: blue; text-align:center"  | <per:unidad>
|Unidad de Medida del Producto
| style="text-align:center;"  |A<nowiki>|</nowiki>3
|-
| style="color: blue; text-align:center"  | <per:valorUnitario>
|Valor Unitario del Producto
| style="text-align:center;"  |N<nowiki>|</nowiki>12,10
|-
|}

Manual de Uso - Portal - Guias de Remision

2024-04-11T04:12:25Z

Peraltaa:

== ¿Cómo ingreso al portal de emisión? ==

-Ingresar a la URL inicial https://demofactura.thefactoryhka.com.pe e ingresar credenciales
en el formulario. Generalmente las credenciales brindadas por su asesor de integraciones es
el RUC para ambas, usuario y contraseña.
 
-Haz clic en Ingresar. 

[[Archivo:Ingresar.png|izquierda|miniaturadeimagen|Imagen: Botón Ingresar - Ambiente Demo]] 

Si el ingreso es exitoso aparecerá el Dashboard del Portal.

[[Archivo:Dashboard.png|izquierda|miniaturadeimagen|Dashboard - Portal de Emisión]]
 

==Requisitos previos para emitir Guías==
=== [https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de datos fiscales] ===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Logotipo Configuración del Logotipo]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de Series]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Sucursales Configuración de Sucursal]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Unidades_de_Medida Agregar Unidades de Medida y Productos]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Clientes Agregar Clientes]===
Si es un cliente PSE es necesario vincular a The Factory como Proveedor de Servicios electrónicos.
===[https://felwiki.thefactoryhka.com.pe/index.php/%C2%BFC%C3%B3mo_vincular_a_The_Factory_HKA_como_PSE%3F Asociación PSE] ===
Si no es un cliente PSE y firma su propio documento , deberá realizar lo siguiente:
===[https://felwiki.thefactoryhka.com.pe/index.php/Cargar_Certificado_Digital_propio Vinculación de Certificado Digital Propio] ===
===[https://cpe.sunat.gob.pe/sites/default/files/inline-files/Manual_Servicios_GRE%20%281%29.pdf Generar Credenciales API SUNAT] ===
[[Archivo:CredencialApiSunat.png|borde|centro|miniaturadeimagen|800x800px|Credenciales API SUNAT]]
Luego de obtener las credenciales API SUNAT para la emisión de Guías de Remisión , deben de registrarlo en el portal de THE FACTORY
 
Una vez hecho exitosamente estos 7 pasos ya podemos emitir guías de remisión
electrónicas.

 
 
== ¿Cómo emitir Guías de Remisión 2.0? ==

Diríjase a la sección de documentos emitidos en documentos => documentos emitidos,
desplegar la flecha a lado de Nuevo Documento y dar clic en Nueva Guía de Remisión.
[[Archivo:EmitiGuia.png|borde|izquierda|miniaturadeimagen|700x700px|Emisión de Guías de Remisión]]
 
 

Luego en la vista generada, Si va generar una guía de remisión - remitente, asegúrese de elegir Guía Remitente 
También asegúrese de seleccionar una serie que fue creada anteriormente para la guía
correspondiente.
[[Archivo:DatosdeGuia.png|izquierda|miniaturadeimagen|655x655px|Información del Documento]]
 

 
Con respecto al llenado del cliente (destinatario), escribir las 3 primeras letras del cliente ya
registrado previamente para que el sistema automáticamente le de sugerencias de clientes con
esas iniciales, clic en el cliente deseado y se añadirá. El mismo procedimiento es para conceptos
(bienes a transportar).

[[Archivo:Destinatario Guia.png|izquierda|miniaturadeimagen|626x626px|Información del Cliente]]
 
Luego llenar los datos correspondientes a la guía, se dará cuenta de que datos son obligatorios
cuando le dé al botón Vista Previa (parte inferior de la página), en la descripción del popup que
aparecerá dirá que es lo faltante, también en algunos de los campos faltantes aparecerá una advertencia de rojo como en la imagen.[[Archivo:InformaciondeGuia.png|borde|izquierda|miniaturadeimagen|516x516px|Información del Traslado]]
 

Una vez llenado todos los campos necesarios, tienes la opción de dar una vista previa al
documento antes de emitirse y verificar que todo este correcto. Para emitir la guía, dar clic en
Generar documento.
[[Archivo:VistaPrevia.png|izquierda|miniaturadeimagen|659x659px|Vista Previa de Guías de Remisión]]

 

El sistema le redirigirá a una lista de documentos emitidos por usted, ahí podrá ver sus guías.
 
En la parte de estatus se irá viendo el progreso actual de la guía: enviando, aceptada o con errores.
 
Si hay algún error que retorne Sunat, aparecerá ahí, haga clic en la palabra con errores para ver el
número y descripción del error, si no puede solucionarlo contacte con el área correspondiente
para su atención, adjuntando un pantallazo del error.
[[Archivo:ListadoDocumentos.png|izquierda|miniaturadeimagen|665x665px|Listado de Guías Emitidas]]

 
En la parte de Acciones, dar clic en la rueda para ver más detalles de la guía.[[Archivo:Acciones.png|izquierda|miniaturadeimagen|500x500px|Acciones del Documento]]

 

Aquí se puede obtener el pdf, xml, cdr de la guía, enviar un correo a una o varias personas,
también ver el historial de envíos de correo o añadir información adicional al pdf de la guía ya
emitida para visualización de su cliente.
Para enviar correo a varias personas coloque los correos separados por “;”, como en la siguiente
imagen.

[[Archivo:EnvioComprobante.png|izquierda|miniaturadeimagen|443x443px|Opción Enviar Correo ]]

Manual de Uso - Portal - Guias de Remision

2024-04-11T04:12:03Z

Peraltaa: /* ¿Cómo emitir Guías de Remisión 2.0? */

== ¿Cómo ingreso al portal de emisión? ==

-Ingresar a la URL inicial https://demofactura.thefactoryhka.com.pe e ingresar credenciales
en el formulario. Generalmente las credenciales brindadas por su asesor de integraciones es
el RUC para ambas, usuario y contraseña.
 
-Haz clic en Ingresar. 

[[Archivo:Ingresar.png|izquierda|miniaturadeimagen|Imagen: Botón Ingresar - Ambiente Demo]] 

Si el ingreso es exitoso aparecerá el Dashboard del Portal.

[[Archivo:Dashboard.png|izquierda|miniaturadeimagen|Dashboard - Portal de Emisión]]
 

==Requisitos previos para emitir Guías==
=== [https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de datos fiscales] ===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Logotipo Configuración del Logotipo]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de Series]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Sucursales Configuración de Sucursal]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Unidades_de_Medida Agregar Unidades de Medida y Productos]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Clientes Agregar Clientes]===
Si es un cliente PSE es necesario vincular a The Factory como Proveedor de Servicios electrónicos.
===[https://felwiki.thefactoryhka.com.pe/index.php/%C2%BFC%C3%B3mo_vincular_a_The_Factory_HKA_como_PSE%3F Asociación PSE] ===
Si no es un cliente PSE y firma su propio documento , deberá realizar lo siguiente:
===[https://felwiki.thefactoryhka.com.pe/index.php/Cargar_Certificado_Digital_propio Vinculación de Certificado Digital Propio] ===
===[https://cpe.sunat.gob.pe/sites/default/files/inline-files/Manual_Servicios_GRE%20%281%29.pdf Generar Credenciales API SUNAT] ===
[[Archivo:CredencialApiSunat.png|borde|centro|miniaturadeimagen|800x800px|Credenciales API SUNAT]]
Luego de obtener las credenciales API SUNAT para la emisión de Guías de Remisión , deben de registrarlo en el portal de THE FACTORY
 
Una vez hecho exitosamente estos 7 pasos ya podemos emitir guías de remisión
electrónicas.

 
 
== ¿Cómo emitir Guías de Remisión 2.0? ==

Diríjase a la sección de documentos emitidos en documentos => documentos emitidos,
desplegar la flecha a lado de Nuevo Documento y dar clic en Nueva Guía de Remisión.
[[Archivo:EmitiGuia.png|borde|izquierda|miniaturadeimagen|700x700px|Emisión de Guías de Remisión]]
 
 

Luego en la vista generada, Si va generar una guía de remisión - remitente, asegúrese de elegir Guía Remitente 
También asegúrese de seleccionar una serie que fue creada anteriormente para la guía
correspondiente.
[[Archivo:DatosdeGuia.png|izquierda|miniaturadeimagen|655x655px|Información del Documento]]
 

 
Con respecto al llenado del cliente (destinatario), escribir las 3 primeras letras del cliente ya
registrado previamente para que el sistema automáticamente le de sugerencias de clientes con
esas iniciales, clic en el cliente deseado y se añadirá. El mismo procedimiento es para conceptos
(bienes a transportar).

[[Archivo:Destinatario Guia.png|izquierda|miniaturadeimagen|626x626px|Información del Cliente]]
 
Luego llenar los datos correspondientes a la guía, se dará cuenta de que datos son obligatorios
cuando le dé al botón Vista Previa (parte inferior de la página), en la descripción del popup que
aparecerá dirá que es lo faltante, también en algunos de los campos faltantes aparecerá una advertencia de rojo como en la imagen.[[Archivo:InformaciondeGuia.png|borde|izquierda|miniaturadeimagen|516x516px|Información del Traslado]]
 

Una vez llenado todos los campos necesarios, tienes la opción de dar una vista previa al
documento antes de emitirse y verificar que todo este correcto. Para emitir la guía, dar clic en
Generar documento.
[[Archivo:VistaPrevia.png|izquierda|miniaturadeimagen|659x659px|Vista Previa de Guías de Remisión]]

 

El sistema le redirigirá a una lista de documentos emitidos por usted, ahí podrá ver sus guías.
 
En la parte de estatus se irá viendo el progreso actual de la guía: enviando, aceptada o con errores.
 
Si hay algún error que retorne Sunat, aparecerá ahí, haga clic en la palabra con errores para ver el
número y descripción del error, si no puede solucionarlo contacte con el área correspondiente
para su atención, adjuntando un pantallazo del error.
[[Archivo:ListadoDocumentos.png|izquierda|miniaturadeimagen|665x665px|Listado de Guías Emitidas]]

 
En la parte de Acciones, dar clic en la rueda para ver más detalles de la guía.[[Archivo:Acciones.png|izquierda|miniaturadeimagen|500x500px|Acciones del Documento]]

 

Aquí se puede obtener el pdf, xml, cdr de la guía, enviar un correo a una o varias personas,
también ver el historial de envíos de correo o añadir información adicional al pdf de la guía ya
emitida para visualización de su cliente.
Para enviar correo a varias personas coloque los correos separados por “;”, como en la siguiente
imagen.

[[Archivo:EnvioComprobante.png|izquierda|miniaturadeimagen|443x443px|Opción Enviar Correo ]]

Archivo:EnvioComprobante.png

2024-04-11T04:10:54Z

Peraltaa:

Envio de Comprobante

Manual de Uso - Portal - Guias de Remision

2024-04-11T04:07:40Z

Peraltaa:

== ¿Cómo ingreso al portal de emisión? ==

-Ingresar a la URL inicial https://demofactura.thefactoryhka.com.pe e ingresar credenciales
en el formulario. Generalmente las credenciales brindadas por su asesor de integraciones es
el RUC para ambas, usuario y contraseña.
 
-Haz clic en Ingresar. 

[[Archivo:Ingresar.png|izquierda|miniaturadeimagen|Imagen: Botón Ingresar - Ambiente Demo]] 

Si el ingreso es exitoso aparecerá el Dashboard del Portal.

[[Archivo:Dashboard.png|izquierda|miniaturadeimagen|Dashboard - Portal de Emisión]]
 

==Requisitos previos para emitir Guías==
=== [https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de datos fiscales] ===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Logotipo Configuración del Logotipo]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de Series]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Sucursales Configuración de Sucursal]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Unidades_de_Medida Agregar Unidades de Medida y Productos]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Clientes Agregar Clientes]===
Si es un cliente PSE es necesario vincular a The Factory como Proveedor de Servicios electrónicos.
===[https://felwiki.thefactoryhka.com.pe/index.php/%C2%BFC%C3%B3mo_vincular_a_The_Factory_HKA_como_PSE%3F Asociación PSE] ===
Si no es un cliente PSE y firma su propio documento , deberá realizar lo siguiente:
===[https://felwiki.thefactoryhka.com.pe/index.php/Cargar_Certificado_Digital_propio Vinculación de Certificado Digital Propio] ===
===[https://cpe.sunat.gob.pe/sites/default/files/inline-files/Manual_Servicios_GRE%20%281%29.pdf Generar Credenciales API SUNAT] ===
[[Archivo:CredencialApiSunat.png|borde|centro|miniaturadeimagen|800x800px|Credenciales API SUNAT]]
Luego de obtener las credenciales API SUNAT para la emisión de Guías de Remisión , deben de registrarlo en el portal de THE FACTORY
 
Una vez hecho exitosamente estos 7 pasos ya podemos emitir guías de remisión
electrónicas.

 
 
== ¿Cómo emitir Guías de Remisión 2.0? ==

Diríjase a la sección de documentos emitidos en documentos => documentos emitidos,
desplegar la flecha a lado de Nuevo Documento y dar clic en Nueva Guía de Remisión.
[[Archivo:EmitiGuia.png|borde|izquierda|miniaturadeimagen|700x700px|Emisión de Guías de Remisión]]
 
 

Luego en la vista generada, Si va generar una guía de remisión - remitente, asegúrese de elegir Guía Remitente 
También asegúrese de seleccionar una serie que fue creada anteriormente para la guía
correspondiente.
[[Archivo:DatosdeGuia.png|izquierda|miniaturadeimagen|655x655px|Información del Documento]]
 

 
Con respecto al llenado del cliente (destinatario), escribir las 3 primeras letras del cliente ya
registrado previamente para que el sistema automáticamente le de sugerencias de clientes con
esas iniciales, clic en el cliente deseado y se añadirá. El mismo procedimiento es para conceptos
(bienes a transportar).

[[Archivo:Destinatario Guia.png|izquierda|miniaturadeimagen|626x626px|Información del Cliente]]
 
Luego llenar los datos correspondientes a la guía, se dará cuenta de que datos son obligatorios
cuando le dé al botón Vista Previa (parte inferior de la página), en la descripción del popup que
aparecerá dirá que es lo faltante, también en algunos de los campos faltantes aparecerá una advertencia de rojo como en la imagen.[[Archivo:InformaciondeGuia.png|borde|izquierda|miniaturadeimagen|516x516px|Información del Traslado]]
 

Una vez llenado todos los campos necesarios, tienes la opción de dar una vista previa al
documento antes de emitirse y verificar que todo este correcto. Para emitir la guía, dar clic en
Generar documento.
[[Archivo:VistaPrevia.png|izquierda|miniaturadeimagen|659x659px|Vista Previa de Guías de Remisión]]

 

El sistema le redirigirá a una lista de documentos emitidos por usted, ahí podrá ver sus guías.
 
En la parte de estatus se irá viendo el progreso actual de la guía: enviando, aceptada o con errores.
 
Si hay algún error que retorne Sunat, aparecerá ahí, haga clic en la palabra con errores para ver el
número y descripción del error, si no puede solucionarlo contacte con el área correspondiente
para su atención, adjuntando un pantallazo del error.
[[Archivo:ListadoDocumentos.png|izquierda|miniaturadeimagen|665x665px|Listado de Guías Emitidas]]

 
En la parte de Acciones, dar clic en la rueda para ver más detalles de la guía.

Aquí se puede obtener el pdf, xml, cdr de la guía, enviar un correo a una o varias personas,
también ver el historial de envíos de correo o añadir información adicional al pdf de la guía ya
emitida para visualización de su cliente.
Para enviar correo a varias personas coloque los correos separados por “;”, como en la siguiente
imagen.
 
[[Archivo:Acciones.png|izquierda|miniaturadeimagen|500x500px|Acciones del Documento]]

Servicio Portal UBL2.1

2024-04-10T20:52:44Z

Peraltaa:

* [[Autoregistro|Autoregistro - HKAPP - Portal de Emisión]]
* [https://factura.thefactoryhka.com.pe/ Accede al Portal de Facturación Electrónica]
* [http://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n Manual de Uso - Portal de Emisión]
*[[Cargar Certificado Digital propio]]
*[[Portal de Recepción de Documentos]]
*[[Portal de Proveedores]]
*[[Gestionar Contactos]]
*[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_-_Guias_de_Remision Manual de Uso - Portal - Guias de Remision]

Servicio Portal UBL2.1

2024-04-10T20:52:24Z

Peraltaa:

* [[Autoregistro|Autoregistro - HKAPP - Portal de Emisión]]
* [https://factura.thefactoryhka.com.pe/ Accede al Portal de Facturación Electrónica]
* [http://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n Manual de Uso - Portal de Emisión]
*[[Cargar Certificado Digital propio]]
*[[Portal de Recepción de Documentos]]
*[[Portal de Proveedores]]
*[[Gestionar Contactos]]
*[[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_-_Guias_de_Remision Manual de Uso - Portal - Guias de Remision]]

Manual de Uso - Portal - Guias de Remision

2024-04-10T20:45:58Z

Peraltaa:

== ¿Cómo ingreso al portal de emisión? ==

-Ingresar a la URL inicial https://demofactura.thefactoryhka.com.pe e ingresar credenciales
en el formulario. Generalmente las credenciales brindadas por su asesor de integraciones es
el RUC para ambas, usuario y contraseña.
 
-Haz clic en Ingresar. 

[[Archivo:Ingresar.png|izquierda|miniaturadeimagen|Imagen: Botón Ingresar - Ambiente Demo]] 

Si el ingreso es exitoso aparecerá el Dashboard del Portal.

[[Archivo:Dashboard.png|izquierda|miniaturadeimagen|Dashboard - Portal de Emisión]]
 

==Requisitos previos para emitir Guías==
=== [https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de datos fiscales] ===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Logotipo Configuración del Logotipo]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de Series]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Sucursales Configuración de Sucursal]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Unidades_de_Medida Agregar Unidades de Medida y Productos]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Clientes Agregar Clientes]===
Si es un cliente PSE es necesario vincular a The Factory como Proveedor de Servicios electrónicos.
===[https://felwiki.thefactoryhka.com.pe/index.php/%C2%BFC%C3%B3mo_vincular_a_The_Factory_HKA_como_PSE%3F Asociación PSE] ===
Si no es un cliente PSE y firma su propio documento , deberá realizar lo siguiente :
===[https://felwiki.thefactoryhka.com.pe/index.php/Cargar_Certificado_Digital_propio Vinculación de Certificado Digital Propio] ===
===[https://cpe.sunat.gob.pe/sites/default/files/inline-files/Manual_Servicios_GRE%20%281%29.pdf Generar Credenciales API SUNAT] ===
[[Archivo:CredencialApiSunat.png|borde|centro|miniaturadeimagen|800x800px|Credenciales API SUNAT]]
Luego de obtener las credenciales API SUNAT para la emisión de Guías de Remisión , deben de registrarlo en el portal de THE FACTORY
 
Una vez hecho exitosamente estos 7 pasos ya podemos emitir guías de remisión
electrónicas.

 
 
== ¿Cómo emitir Guías de Remisión 2.0? ==

Diríjase a la sección de documentos emitidos en documentos => documentos emitidos,
desplegar la flecha a lado de Nuevo Documento y dar clic en Nueva Guía de Remisión.
[[Archivo:EmitiGuia.png|borde|izquierda|miniaturadeimagen|700x700px|Emisión de Guías de Remisión]]
 
 

Luego en la vista generada, Si va generar una guía de remisión - remitente, asegúrese de elegir Guía Remitente 
También asegúrese de seleccionar una serie que fue creada anteriormente para la guía
correspondiente.
[[Archivo:DatosdeGuia.png|izquierda|miniaturadeimagen|655x655px|Información del Documento]]
 

 
Con respecto al llenado del cliente (destinatario), escribir las 3 primeras letras del cliente ya
registrado previamente para que el sistema automáticamente le de sugerencias de clientes con
esas iniciales, clic en el cliente deseado y se añadirá. El mismo procedimiento es para conceptos
(bienes a transportar).

[[Archivo:Destinatario Guia.png|izquierda|miniaturadeimagen|626x626px|Información del Cliente]]
 
Luego llenar los datos correspondientes a la guía, se dará cuenta de que datos son obligatorios
cuando le dé al botón Vista Previa (parte inferior de la página), en la descripción del popup que
aparecerá dirá que es lo faltante, también en algunos de los campos faltantes aparecerá una
advertencia de rojo como en la imagen.[[Archivo:InformaciondeGuia.png|borde|izquierda|miniaturadeimagen|516x516px|Información del Traslado]]
 

Una vez llenado todos los campos necesarios, tienes la opción de dar una vista previa al
documento antes de emitirse y verificar que todo este correcto. Para emitir la guía, dar clic en
Generar documento.
[[Archivo:VistaPrevia.png|izquierda|miniaturadeimagen|659x659px|Vista Previa de Guías de Remisión]]

 

El sistema le redirigirá a una lista de documentos emitidos por usted, ahí podrá ver sus guías.
 
En la parte de estatus se irá viendo el progreso actual de la guía: enviando, aceptada o con errores.
 
Si hay algún error que retorne Sunat, aparecerá ahí, haga clic en la palabra con errores para ver el
numeró y descripción del error, si no puede solucionarlo contacte con el área correspondiente
para su atención, adjuntando un pantallazo del error.
[[Archivo:ListadoDocumentos.png|izquierda|miniaturadeimagen|665x665px|Listado de Guías Emitidas]]

 
En la parte de Acciones, dar clic en la rueda para ver más detalles de la guía.
 
[[Archivo:Acciones.png|izquierda|miniaturadeimagen|500x500px|Acciones del Documento]]

 
Aquí se puede obtener el pdf, xml, cdr de la guía, enviar un correo a una o varias personas,
también ver el historial de envíos de correo o añadir información adicional al pdf de la guía ya
emitida para visualización de su cliente.
Para enviar correo a varias personas coloque los correos separados por “;”, como en la siguiente
imagen.

Manual de Uso - Portal - Guias de Remision

2024-04-10T20:45:37Z

Peraltaa:

== ¿Cómo ingreso al portal de emisión? ==

-Ingresar a la URL inicial https://demofactura.thefactoryhka.com.pe e ingresar credenciales
en el formulario. Generalmente las credenciales brindadas por su asesor de integraciones es
el RUC para ambas, usuario y contraseña.
 
-Haz clic en Ingresar. 

[[Archivo:Ingresar.png|izquierda|miniaturadeimagen|Imagen: Botón Ingresar - Ambiente Demo]] 

Si el ingreso es exitoso aparecerá el Dashboard del Portal.

[[Archivo:Dashboard.png|izquierda|miniaturadeimagen|Dashboard - Portal de Emisión]]
 

==Requisitos previos para emitir Guías==
=== [https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de datos fiscales] ===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Logotipo Configuración del Logotipo]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de Series]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Sucursales Configuración de Sucursal]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Unidades_de_Medida Agregar Unidades de Medida y Productos]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Clientes Agregar Clientes]===
Si es un cliente PSE es necesario vincular a The Factory como Proveedor de Servicios electrónicos.
===[https://felwiki.thefactoryhka.com.pe/index.php/%C2%BFC%C3%B3mo_vincular_a_The_Factory_HKA_como_PSE%3F Asociación PSE] ===
Si no es un cliente PSE y firma su propio documento , deberá realizar lo siguiente :
===[https://felwiki.thefactoryhka.com.pe/index.php/Cargar_Certificado_Digital_propio Vinculación de Certificado Digital Propio] ===
===[https://cpe.sunat.gob.pe/sites/default/files/inline-files/Manual_Servicios_GRE%20%281%29.pdf Generar Credenciales API SUNAT] ===
[[Archivo:CredencialApiSunat.png|borde|centro|miniaturadeimagen|800x800px|Credenciales API SUNAT]]
Luego de obtener las credenciales API SUNAT para la emisión de Guías de Remisión , deben de registrarlo en el portal de THE FACTORY
 
Una vez hecho exitosamente estos 7 pasos ya podemos emitir guías de remisión
electrónicas.

 
 
== ¿Cómo emitir Guías de Remisión 2.0? ==

Diríjase a la sección de documentos emitidos en documentos => documentos emitidos,
desplegar la flecha a lado de Nuevo Documento y dar clic en Nueva Guía de Remisión.
[[Archivo:EmitiGuia.png|borde|izquierda|miniaturadeimagen|700x700px|Emisión de Guías de Remisión]]
 
 

Luego en la vista generada, Si va generar una guía de remisión - remitente, asegúrese de elegir Guía Remitente 
También asegúrese de seleccionar una serie que fue creada anteriormente para la guía
correspondiente.
[[Archivo:DatosdeGuia.png|izquierda|miniaturadeimagen|655x655px|Información del Documento]]
 

 
Con respecto al llenado del cliente (destinatario), escribir las 3 primeras letras del cliente ya
registrado previamente para que el sistema automáticamente le de sugerencias de clientes con
esas iniciales, clic en el cliente deseado y se añadirá. El mismo procedimiento es para conceptos
(bienes a transportar).

[[Archivo:Destinatario Guia.png|izquierda|miniaturadeimagen|626x626px|Información del Cliente]]
 
Luego llenar los datos correspondientes a la guía, se dará cuenta de que datos son obligatorios
cuando le dé al botón Vista Previa (parte inferior de la página), en la descripción del popup que
aparecerá dirá que es lo faltante, también en algunos de los campos faltantes aparecerá una
advertencia de rojo como en la imagen.[[Archivo:InformaciondeGuia.png|borde|izquierda|miniaturadeimagen|516x516px|Información del Traslado]]
 

Una vez llenado todos los campos necesarios, tienes la opción de dar una vista previa al
documento antes de emitirse y verificar que todo este correcto. Para emitir la guía, dar clic en
Generar documento.
[[Archivo:VistaPrevia.png|izquierda|miniaturadeimagen|659x659px|Vista Previa de Guías de Remisión]]

 

El sistema le redirigirá a una lista de documentos emitidos por usted, ahí podrá ver sus guías.
 
En la parte de estatus se irá viendo el progreso actual de la guía: enviando, aceptada o con errores.
 
Si hay algún error que retorne Sunat, aparecerá ahí, haga clic en la palabra con errores para ver el
numeró y descripción del error, si no puede solucionarlo contacte con el área correspondiente
para su atención, adjuntando un pantallazo del error.
[[Archivo:ListadoDocumentos.png|izquierda|miniaturadeimagen|665x665px|Listado de Guías Emitidas]]

 
En la parte de Acciones, dar clic en la rueda para ver más detalles de la guía.
 
[[Archivo:Acciones.png|izquierda|miniaturadeimagen|500x500px|Acciones del Documento]]

 
Aquí se puede obtener el pdf, xml, cdr de la guía, enviar un correo a una o varias personas,
también ver el historial de envíos de correo o añadir información adicional al pdf de la guía ya
emitida para visualización de su cliente.
Para enviar correo a varias personas coloque los correos separados por “;”, como en la siguiente
imagen.

Manual de Uso - Portal - Guias de Remision

2024-04-10T20:45:07Z

Peraltaa:

== ¿Cómo ingreso al portal de emisión? ==

-Ingresar a la URL inicial https://demofactura.thefactoryhka.com.pe e ingresar credenciales
en el formulario. Generalmente las credenciales brindadas por su asesor de integraciones es
el RUC para ambas, usuario y contraseña.
 
-Haz clic en Ingresar. 

[[Archivo:Ingresar.png|izquierda|miniaturadeimagen|Imagen: Botón Ingresar - Ambiente Demo]] 

Si el ingreso es exitoso aparecerá el Dashboard del Portal.

[[Archivo:Dashboard.png|izquierda|miniaturadeimagen|Dashboard - Portal de Emisión]]
 

==Requisitos previos para emitir Guías==
=== [https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de datos fiscales] ===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Logotipo Configuración del Logotipo]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de Series]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Sucursales Configuración de Sucursal]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Unidades_de_Medida Agregar Unidades de Medida y Productos]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Clientes Agregar Clientes]===
Si es un cliente PSE es necesario vincular a The Factory como Proveedor de Servicios electrónicos.
===[https://felwiki.thefactoryhka.com.pe/index.php/%C2%BFC%C3%B3mo_vincular_a_The_Factory_HKA_como_PSE%3F Asociación PSE] ===
Si no es un cliente PSE y firma su propio documento , deberá realizar lo siguiente :
===[https://felwiki.thefactoryhka.com.pe/index.php/Cargar_Certificado_Digital_propio Vinculación de Certificado Digital Propio] ===
===[https://cpe.sunat.gob.pe/sites/default/files/inline-files/Manual_Servicios_GRE%20%281%29.pdf Generar Credenciales API SUNAT] ===
[[Archivo:CredencialApiSunat.png|borde|centro|miniaturadeimagen|800x800px|Credenciales API SUNAT]]
Luego de obtener las credenciales API SUNAT para la emisión de Guías de Remisión , deben de registrarlo en el portal de THE FACTORY
 
Una vez hecho exitosamente estos 7 pasos ya podemos emitir guías de remisión
electrónicas.

 
 
== ¿Cómo emitir Guías de Remisión 2.0? ==

Diríjase a la sección de documentos emitidos en documentos => documentos emitidos,
desplegar la flecha a lado de Nuevo Documento y dar clic en Nueva Guía de Remisión.
[[Archivo:EmitiGuia.png|borde|izquierda|miniaturadeimagen|700x700px|Emisión de Guías de Remisión]]
 
 

Luego en la vista generada, Si va generar una guía de remisión - remitente, asegúrese de elegir Guía Remitente 
También asegúrese de seleccionar una serie que fue creada anteriormente para la guía
correspondiente.
[[Archivo:DatosdeGuia.png|izquierda|miniaturadeimagen|655x655px|Información del Documento]]
 

 
Con respecto al llenado del cliente (destinatario), escribir las 3 primeras letras del cliente ya
registrado previamente para que el sistema automáticamente le de sugerencias de clientes con
esas iniciales, clic en el cliente deseado y se añadirá. El mismo procedimiento es para conceptos
(bienes a transportar).

[[Archivo:Destinatario Guia.png|izquierda|miniaturadeimagen|626x626px|Información del Cliente]]
 
Luego llenar los datos correspondientes a la guía, se dará cuenta de que datos son obligatorios
cuando le dé al botón Vista Previa (parte inferior de la página), en la descripción del popup que
aparecerá dirá que es lo faltante, también en algunos de los campos faltantes aparecerá una
advertencia de rojo como en la imagen.[[Archivo:InformaciondeGuia.png|borde|izquierda|miniaturadeimagen|516x516px|Información del Traslado]]
 

Una vez llenado todos los campos necesarios, tienes la opción de dar una vista previa al
documento antes de emitirse y verificar que todo este correcto. Para emitir la guía, dar clic en
Generar documento.
[[Archivo:VistaPrevia.png|izquierda|miniaturadeimagen|659x659px|Vista Previa de Guías de Remisión]]

 

El sistema le redirigirá a una lista de documentos emitidos por usted, ahí podrá ver sus guías.
 
En la parte de estatus se irá viendo el progreso actual de la guía: enviando, aceptada o con errores.
 
Si hay algún error que retorne Sunat, aparecerá ahí, haga clic en la palabra con errores para ver el
numeró y descripción del error, si no puede solucionarlo contacte con el área correspondiente
para su atención, adjuntando un pantallazo del error.
[[Archivo:ListadoDocumentos.png|izquierda|miniaturadeimagen|665x665px|Listado de Guías Emitidas]]

 
En la parte de Acciones, dar clic en la rueda para ver más detalles de la guía.
 
[[Archivo:Acciones.png|izquierda|miniaturadeimagen|500x500px|Acciones del Documento]]

 
Aquí se puede obtener el pdf, xml, cdr de la guía, enviar un correo a una o varias personas,
también ver el historial de envíos de correo o añadir información adicional al pdf de la guía ya
emitida para visualización de su cliente.
Para enviar correo a varias personas coloque los correos separados por “;”, como en la siguiente
imagen.

Manual de Uso - Portal - Guias de Remision

2024-04-10T20:44:34Z

Peraltaa:

== ¿Cómo ingreso al portal de emisión? ==

-Ingresar a la URL inicial https://demofactura.thefactoryhka.com.pe e ingresar credenciales
en el formulario. Generalmente las credenciales brindadas por su asesor de integraciones es
el RUC para ambas, usuario y contraseña.
 
-Haz clic en Ingresar. 

[[Archivo:Ingresar.png|izquierda|miniaturadeimagen|Imagen: Botón Ingresar - Ambiente Demo]] 

Si el ingreso es exitoso aparecerá el Dashboard del Portal.

[[Archivo:Dashboard.png|izquierda|miniaturadeimagen|Dashboard - Portal de Emisión]]
 

==Requisitos previos para emitir Guías==
=== [https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de datos fiscales] ===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Logotipo Configuración del Logotipo]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de Series]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Sucursales Configuración de Sucursal]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Unidades_de_Medida Agregar Unidades de Medida y Productos]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Clientes Agregar Clientes]===
Si es un cliente PSE es necesario vincular a The Factory como Proveedor de Servicios electrónicos.
===[https://felwiki.thefactoryhka.com.pe/index.php/%C2%BFC%C3%B3mo_vincular_a_The_Factory_HKA_como_PSE%3F Asociación PSE] ===
Si no es un cliente PSE y firma su propio documento , deberá realizar lo siguiente :
===[https://felwiki.thefactoryhka.com.pe/index.php/Cargar_Certificado_Digital_propio Vinculación de Certificado Digital Propio] ===
===[https://cpe.sunat.gob.pe/sites/default/files/inline-files/Manual_Servicios_GRE%20%281%29.pdf Generar Credenciales API SUNAT] ===
[[Archivo:CredencialApiSunat.png|borde|centro|miniaturadeimagen|800x800px|Credenciales API SUNAT]]
Luego de obtener las credenciales API SUNAT para la emisión de Guías de Remisión , deben de registrarlo en el portal de THE FACTORY
 
Una vez hecho exitosamente estos 7 pasos ya podemos emitir guías de remisión
electrónicas.

 
 
== ¿Cómo emitir Guías de Remisión 2.0? ==

Diríjase a la sección de documentos emitidos en documentos => documentos emitidos,
desplegar la flecha a lado de Nuevo Documento y dar clic en Nueva Guía de Remisión.
[[Archivo:EmitiGuia.png|borde|izquierda|miniaturadeimagen|700x700px|Emisión de Guías de Remisión]]
 
 

Luego en la vista generada, Si va generar una guía de remisión - remitente, asegúrese de elegir Guía Remitente 
También asegúrese de seleccionar una serie que fue creada anteriormente para la guía
correspondiente.
[[Archivo:DatosdeGuia.png|izquierda|miniaturadeimagen|655x655px|Información del Documento]]
 

 
Con respecto al llenado del cliente (destinatario), escribir las 3 primeras letras del cliente ya
registrado previamente para que el sistema automáticamente le de sugerencias de clientes con
esas iniciales, clic en el cliente deseado y se añadirá. El mismo procedimiento es para conceptos
(bienes a transportar).

[[Archivo:Destinatario Guia.png|izquierda|miniaturadeimagen|626x626px|Información del Cliente]]
 
Luego llenar los datos correspondientes a la guía, se dará cuenta de que datos son obligatorios
cuando le dé al botón Vista Previa (parte inferior de la página), en la descripción del popup que
aparecerá dirá que es lo faltante, también en algunos de los campos faltantes aparecerá una
advertencia de rojo como en la imagen.[[Archivo:InformaciondeGuia.png|borde|izquierda|miniaturadeimagen|516x516px|Información del Traslado]]
 

Una vez llenado todos los campos necesarios, tienes la opción de dar una vista previa al
documento antes de emitirse y verificar que todo este correcto. Para emitir la guía, dar clic en
Generar documento.
[[Archivo:VistaPrevia.png|izquierda|miniaturadeimagen|659x659px|Vista Previa de Guías de Remisión]]

 

El sistema le redirigirá a una lista de documentos emitidos por usted, ahí podrá ver sus guías.
 
En la parte de estatus se irá viendo el progreso actual de la guía: enviando, aceptada o con errores.
 
Si hay algún error que retorne Sunat, aparecerá ahí, haga clic en la palabra con errores para ver el
numeró y descripción del error, si no puede solucionarlo contacte con el área correspondiente
para su atención, adjuntando un pantallazo del error.
[[Archivo:ListadoDocumentos.png|izquierda|miniaturadeimagen|665x665px|Listado de Guías Emitidas]]

 
En la parte de Acciones, dar clic en la rueda para ver más detalles de la guía.
 
[[Archivo:Acciones.png|izquierda|miniaturadeimagen|500x500px|Acciones del Documento]]

Aquí se puede obtener el pdf, xml, cdr de la guía, enviar un correo a una o varias personas,
también ver el historial de envíos de correo o añadir información adicional al pdf de la guía ya
emitida para visualización de su cliente.
Para enviar correo a varias personas coloque los correos separados por “;”, como en la siguiente
imagen.

Manual de Uso - Portal - Guias de Remision

2024-04-10T20:43:51Z

Peraltaa:

== ¿Cómo ingreso al portal de emisión? ==

-Ingresar a la URL inicial https://demofactura.thefactoryhka.com.pe e ingresar credenciales
en el formulario. Generalmente las credenciales brindadas por su asesor de integraciones es
el RUC para ambas, usuario y contraseña.
 
-Haz clic en Ingresar. 

[[Archivo:Ingresar.png|izquierda|miniaturadeimagen|Imagen: Botón Ingresar - Ambiente Demo]] 

Si el ingreso es exitoso aparecerá el Dashboard del Portal.

[[Archivo:Dashboard.png|izquierda|miniaturadeimagen|Dashboard - Portal de Emisión]]
 

==Requisitos previos para emitir Guías==
=== [https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de datos fiscales] ===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Logotipo Configuración del Logotipo]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de Series]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Sucursales Configuración de Sucursal]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Unidades_de_Medida Agregar Unidades de Medida y Productos]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Clientes Agregar Clientes]===
Si es un cliente PSE es necesario vincular a The Factory como Proveedor de Servicios electrónicos.
===[https://felwiki.thefactoryhka.com.pe/index.php/%C2%BFC%C3%B3mo_vincular_a_The_Factory_HKA_como_PSE%3F Asociación PSE] ===
Si no es un cliente PSE y firma su propio documento , deberá realizar lo siguiente :
===[https://felwiki.thefactoryhka.com.pe/index.php/Cargar_Certificado_Digital_propio Vinculación de Certificado Digital Propio] ===
===[https://cpe.sunat.gob.pe/sites/default/files/inline-files/Manual_Servicios_GRE%20%281%29.pdf Generar Credenciales API SUNAT] ===
[[Archivo:CredencialApiSunat.png|borde|centro|miniaturadeimagen|800x800px|Credenciales API SUNAT]]
Luego de obtener las credenciales API SUNAT para la emisión de Guías de Remisión , deben de registrarlo en el portal de THE FACTORY
 
Una vez hecho exitosamente estos 7 pasos ya podemos emitir guías de remisión
electrónicas.

 
 
== ¿Cómo emitir Guías de Remisión 2.0? ==

Diríjase a la sección de documentos emitidos en documentos => documentos emitidos,
desplegar la flecha a lado de Nuevo Documento y dar clic en Nueva Guía de Remisión.
[[Archivo:EmitiGuia.png|borde|izquierda|miniaturadeimagen|700x700px|Emisión de Guías de Remisión]]
 
 

Luego en la vista generada, Si va generar una guía de remisión - remitente, asegúrese de elegir Guía Remitente 
También asegúrese de seleccionar una serie que fue creada anteriormente para la guía
correspondiente.
[[Archivo:DatosdeGuia.png|izquierda|miniaturadeimagen|655x655px|Información del Documento]]
 
Con respecto al llenado del cliente (destinatario), escribir las 3 primeras letras del cliente ya
registrado previamente para que el sistema automáticamente le de sugerencias de clientes con
esas iniciales, clic en el cliente deseado y se añadirá. El mismo procedimiento es para conceptos
(bienes a transportar).
[[Archivo:Destinatario Guia.png|izquierda|miniaturadeimagen|626x626px|Información del Cliente]]
 
Luego llenar los datos correspondientes a la guía, se dará cuenta de que datos son obligatorios
cuando le dé al botón Vista Previa (parte inferior de la página), en la descripción del popup que
aparecerá dirá que es lo faltante, también en algunos de los campos faltantes aparecerá una
advertencia de rojo como en la imagen.[[Archivo:InformaciondeGuia.png|borde|izquierda|miniaturadeimagen|516x516px|Información del Traslado]]
 

Una vez llenado todos los campos necesarios, tienes la opción de dar una vista previa al
documento antes de emitirse y verificar que todo este correcto. Para emitir la guía, dar clic en
Generar documento.
[[Archivo:VistaPrevia.png|izquierda|miniaturadeimagen|659x659px|Vista Previa de Guías de Remisión]]

 

El sistema le redirigirá a una lista de documentos emitidos por usted, ahí podrá ver sus guías.
 
En la parte de estatus se irá viendo el progreso actual de la guía: enviando, aceptada o con errores.
 
Si hay algún error que retorne Sunat, aparecerá ahí, haga clic en la palabra con errores para ver el
numeró y descripción del error, si no puede solucionarlo contacte con el área correspondiente
para su atención, adjuntando un pantallazo del error.
[[Archivo:ListadoDocumentos.png|izquierda|miniaturadeimagen|665x665px|Listado de Guías Emitidas]]

 
En la parte de Acciones, dar clic en la rueda para ver más detalles de la guía.
 
[[Archivo:Acciones.png|izquierda|miniaturadeimagen|500x500px|Acciones del Documento]]

Aquí se puede obtener el pdf, xml, cdr de la guía, enviar un correo a una o varias personas,
también ver el historial de envíos de correo o añadir información adicional al pdf de la guía ya
emitida para visualización de su cliente.
Para enviar correo a varias personas coloque los correos separados por “;”, como en la siguiente
imagen.

Manual de Uso - Portal - Guias de Remision

2024-04-10T20:41:06Z

Peraltaa: /* ¿Cómo emitir Guías de Remisión 2.0? */

== ¿Cómo ingreso al portal de emisión? ==

-Ingresar a la URL inicial https://demofactura.thefactoryhka.com.pe e ingresar credenciales
en el formulario. Generalmente las credenciales brindadas por su asesor de integraciones es
el RUC para ambas, usuario y contraseña.
 
-Haz clic en Ingresar. 

[[Archivo:Ingresar.png|izquierda|miniaturadeimagen|Imagen: Botón Ingresar - Ambiente Demo]] 

Si el ingreso es exitoso aparecerá el Dashboard del Portal.

[[Archivo:Dashboard.png|izquierda|miniaturadeimagen|Dashboard - Portal de Emisión]]
 

==Requisitos previos para emitir Guías==
=== [https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de datos fiscales] ===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Logotipo Configuración del Logotipo]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de Series]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Sucursales Configuración de Sucursal]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Unidades_de_Medida Agregar Unidades de Medida y Productos]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Clientes Agregar Clientes]===
Si es un cliente PSE es necesario vincular a The Factory como Proveedor de Servicios electrónicos.
===[https://felwiki.thefactoryhka.com.pe/index.php/%C2%BFC%C3%B3mo_vincular_a_The_Factory_HKA_como_PSE%3F Asociación PSE] ===
Si no es un cliente PSE y firma su propio documento , deberá realizar lo siguiente :
===[https://felwiki.thefactoryhka.com.pe/index.php/Cargar_Certificado_Digital_propio Vinculación de Certificado Digital Propio] ===
===[https://cpe.sunat.gob.pe/sites/default/files/inline-files/Manual_Servicios_GRE%20%281%29.pdf Generar Credenciales API SUNAT] ===
[[Archivo:CredencialApiSunat.png|borde|centro|miniaturadeimagen|800x800px|Credenciales API SUNAT]]
Luego de obtener las credenciales API SUNAT para la emisión de Guías de Remisión , deben de registrarlo en el portal de THE FACTORY
 
Una vez hecho exitosamente estos 7 pasos ya podemos emitir guías de remisión
electrónicas.

 
 
== ¿Cómo emitir Guías de Remisión 2.0? ==

Diríjase a la sección de documentos emitidos en documentos => documentos emitidos,
desplegar la flecha a lado de Nuevo Documento y dar clic en Nueva Guía de Remisión.
[[Archivo:EmitiGuia.png|borde|izquierda|miniaturadeimagen|700x700px|Emisión de Guías de Remisión]]
 
 

Luego en la vista generada, Si va generar una guía de remisión - remitente, asegúrese de elegir Guía Remitente 
También asegúrese de seleccionar una serie que fue creada anteriormente para la guía
correspondiente.
[[Archivo:DatosdeGuia.png|izquierda|miniaturadeimagen|655x655px|Información del Documento]]
 

Con respecto al llenado del cliente (destinatario), escribir las 3 primeras letras del cliente ya
registrado previamente para que el sistema automáticamente le de sugerencias de clientes con
esas iniciales, clic en el cliente deseado y se añadirá. El mismo procedimiento es para conceptos
(bienes a transportar).
[[Archivo:Destinatario Guia.png|izquierda|miniaturadeimagen|626x626px|Información del Cliente]]
 

Luego llenar los datos correspondientes a la guía, se dará cuenta de que datos son obligatorios
cuando le dé al botón Vista Previa (parte inferior de la página), en la descripción del popup que
aparecerá dirá que es lo faltante, también en algunos de los campos faltantes aparecerá una
advertencia de rojo como en la imagen.

[[Archivo:InformaciondeGuia.png|borde|izquierda|miniaturadeimagen|516x516px|Información del Traslado]]
 

Una vez llenado todos los campos necesarios, tienes la opción de dar una vista previa al
documento antes de emitirse y verificar que todo este correcto. Para emitir la guía, dar clic en
Generar documento.
[[Archivo:VistaPrevia.png|izquierda|miniaturadeimagen|500x500px|Vista Previa de Guías de Remisión]]

 
[[Archivo:ListadoDocumentos.png|izquierda|miniaturadeimagen|500x500px|Listado de Guías Emitidas]]
El sistema le redirigirá a una lista de documentos emitidos por usted, ahí podrá ver sus guías.
 
En la parte de estatus se irá viendo el progreso actual de la guía: enviando, aceptada o con errores.
 
Si hay algún error que retorne Sunat, aparecerá ahí, haga clic en la palabra con errores para ver el
numeró y descripción del error, si no puede solucionarlo contacte con el área correspondiente
para su atención, adjuntando un pantallazo del error.

 
En la parte de Acciones, dar clic en la rueda para ver más detalles de la guía.
 
[[Archivo:Acciones.png|izquierda|miniaturadeimagen|500x500px|Acciones del Documento]]
Aquí se puede obtener el pdf, xml, cdr de la guía, enviar un correo a una o varias personas,
también ver el historial de envíos de correo o añadir información adicional al pdf de la guía ya
emitida para visualización de su cliente.
Para enviar correo a varias personas coloque los correos separados por “;”, como en la siguiente
imagen.

Manual de Uso - Portal - Guias de Remision

2024-04-10T20:39:30Z

Peraltaa:

== ¿Cómo ingreso al portal de emisión? ==

-Ingresar a la URL inicial https://demofactura.thefactoryhka.com.pe e ingresar credenciales
en el formulario. Generalmente las credenciales brindadas por su asesor de integraciones es
el RUC para ambas, usuario y contraseña.
 
-Haz clic en Ingresar. 

[[Archivo:Ingresar.png|izquierda|miniaturadeimagen|Imagen: Botón Ingresar - Ambiente Demo]] 

Si el ingreso es exitoso aparecerá el Dashboard del Portal.

[[Archivo:Dashboard.png|izquierda|miniaturadeimagen|Dashboard - Portal de Emisión]]
 

==Requisitos previos para emitir Guías==
=== [https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de datos fiscales] ===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Logotipo Configuración del Logotipo]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de Series]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Sucursales Configuración de Sucursal]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Unidades_de_Medida Agregar Unidades de Medida y Productos]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Clientes Agregar Clientes]===
Si es un cliente PSE es necesario vincular a The Factory como Proveedor de Servicios electrónicos.
===[https://felwiki.thefactoryhka.com.pe/index.php/%C2%BFC%C3%B3mo_vincular_a_The_Factory_HKA_como_PSE%3F Asociación PSE] ===
Si no es un cliente PSE y firma su propio documento , deberá realizar lo siguiente :
===[https://felwiki.thefactoryhka.com.pe/index.php/Cargar_Certificado_Digital_propio Vinculación de Certificado Digital Propio] ===
===[https://cpe.sunat.gob.pe/sites/default/files/inline-files/Manual_Servicios_GRE%20%281%29.pdf Generar Credenciales API SUNAT] ===
[[Archivo:CredencialApiSunat.png|borde|centro|miniaturadeimagen|800x800px|Credenciales API SUNAT]]
Luego de obtener las credenciales API SUNAT para la emisión de Guías de Remisión , deben de registrarlo en el portal de THE FACTORY
 
Una vez hecho exitosamente estos 7 pasos ya podemos emitir guías de remisión
electrónicas.

 
 
== ¿Cómo emitir Guías de Remisión 2.0? ==

Diríjase a la sección de documentos emitidos en documentos => documentos emitidos,
desplegar la flecha a lado de Nuevo Documento y dar clic en Nueva Guía de Remisión.
[[Archivo:EmitiGuia.png|borde|izquierda|miniaturadeimagen|700x700px|Emisión de Guías de Remisión]]
 
 

Luego en la vista generada, Si va generar una guía de remisión - remitente, asegúrese de elegir Guía Remitente 
También asegúrese de seleccionar una serie que fue creada anteriormente para la guía
correspondiente.
[[Archivo:DatosdeGuia.png|izquierda|miniaturadeimagen|655x655px|Información del Documento]]
 

Con respecto al llenado del cliente (destinatario), escribir las 3 primeras letras del cliente ya
registrado previamente para que el sistema automáticamente le de sugerencias de clientes con
esas iniciales, clic en el cliente deseado y se añadirá. El mismo procedimiento es para conceptos
(bienes a transportar).
[[Archivo:Destinatario Guia.png|izquierda|miniaturadeimagen|626x626px|Información del Cliente]]
 

Luego llenar los datos correspondientes a la guía, se dará cuenta de que datos son obligatorios
cuando le dé al botón Vista Previa (parte inferior de la página), en la descripción del popup que
aparecerá dirá que es lo faltante, también en algunos de los campos faltantes aparecerá una
advertencia de rojo como en la imagen.

[[Archivo:InformaciondeGuia.png|borde|izquierda|miniaturadeimagen|516x516px|Información del Traslado]]
 

Una vez llenado todos los campos necesarios, tienes la opción de dar una vista previa al
documento antes de emitirse y verificar que todo este correcto. Para emitir la guía, dar clic en
Generar documento.
[[Archivo:VistaPrevia.png|izquierda|miniaturadeimagen|500x500px|Vista Previa de Guías de Remisión]]

 
[[Archivo:ListadoDocumentos.png|izquierda|miniaturadeimagen|500x500px|Listado de Guías Emitidas]]
El sistema le redirigirá a una lista de documentos emitidos por usted, ahí podrá ver sus guías.
 
En la parte de estatus se irá viendo el progreso actual de la guía: enviando, aceptada o con errores.
 
Si hay algún error que retorne Sunat, aparecerá ahí, haga clic en la palabra con errores para ver el
numeró y descripción del error, si no puede solucionarlo contacte con el área correspondiente
para su atención, adjuntando un pantallazo del error.

 
[[Archivo:Acciones.png|izquierda|miniaturadeimagen|500x500px|Acciones del Documento]]
En la parte de Acciones, dar clic en la rueda para ver más detalles de la guía.

 

Aquí se puede obtener el pdf, xml, cdr de la guía, enviar un correo a una o varias personas,
también ver el historial de envíos de correo o añadir información adicional al pdf de la guía ya
emitida para visualización de su cliente.
Para enviar correo a varias personas coloque los correos separados por “;”, como en la siguiente
imagen.

Manual de Uso - Portal - Guias de Remision

2024-04-10T20:38:58Z

Peraltaa:

== ¿Cómo ingreso al portal de emisión? ==

-Ingresar a la URL inicial https://demofactura.thefactoryhka.com.pe e ingresar credenciales
en el formulario. Generalmente las credenciales brindadas por su asesor de integraciones es
el RUC para ambas, usuario y contraseña.
 
-Haz clic en Ingresar. 

[[Archivo:Ingresar.png|izquierda|miniaturadeimagen|Imagen: Botón Ingresar - Ambiente Demo]] 

Si el ingreso es exitoso aparecerá el Dashboard del Portal.

[[Archivo:Dashboard.png|izquierda|miniaturadeimagen|Dashboard - Portal de Emisión]]
 

==Requisitos previos para emitir Guías==
=== [https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de datos fiscales] ===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Logotipo Configuración del Logotipo]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de Series]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Sucursales Configuración de Sucursal]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Unidades_de_Medida Agregar Unidades de Medida y Productos]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Clientes Agregar Clientes]===
Si es un cliente PSE es necesario vincular a The Factory como Proveedor de Servicios electrónicos.
===[https://felwiki.thefactoryhka.com.pe/index.php/%C2%BFC%C3%B3mo_vincular_a_The_Factory_HKA_como_PSE%3F Asociación PSE] ===
Si no es un cliente PSE y firma su propio documento , deberá realizar lo siguiente :
===[https://felwiki.thefactoryhka.com.pe/index.php/Cargar_Certificado_Digital_propio Vinculación de Certificado Digital Propio] ===
===[https://cpe.sunat.gob.pe/sites/default/files/inline-files/Manual_Servicios_GRE%20%281%29.pdf Generar Credenciales API SUNAT] ===
[[Archivo:CredencialApiSunat.png|borde|centro|miniaturadeimagen|800x800px|Credenciales API SUNAT]]
Luego de obtener las credenciales API SUNAT para la emisión de Guías de Remisión , deben de registrarlo en el portal de THE FACTORY
 
Una vez hecho exitosamente estos 7 pasos ya podemos emitir guías de remisión
electrónicas.

 
 
== ¿Cómo emitir Guías de Remisión 2.0? ==

Diríjase a la sección de documentos emitidos en documentos => documentos emitidos,
desplegar la flecha a lado de Nuevo Documento y dar clic en Nueva Guía de Remisión.
[[Archivo:EmitiGuia.png|borde|izquierda|miniaturadeimagen|700x700px|Emisión de Guías de Remisión]]
 
 

Luego en la vista generada, Si va generar una guía de remisión - remitente, asegúrese de elegir Guía Remitente 
También asegúrese de seleccionar una serie que fue creada anteriormente para la guía
correspondiente.
[[Archivo:DatosdeGuia.png|izquierda|miniaturadeimagen|655x655px|Información del Documento]]
 

Con respecto al llenado del cliente (destinatario), escribir las 3 primeras letras del cliente ya
registrado previamente para que el sistema automáticamente le de sugerencias de clientes con
esas iniciales, clic en el cliente deseado y se añadirá. El mismo procedimiento es para conceptos
(bienes a transportar).
[[Archivo:Destinatario Guia.png|izquierda|miniaturadeimagen|626x626px|Información del Cliente]]
 

Luego llenar los datos correspondientes a la guía, se dará cuenta de que datos son obligatorios
cuando le dé al botón Vista Previa (parte inferior de la página), en la descripción del popup que
aparecerá dirá que es lo faltante, también en algunos de los campos faltantes aparecerá una
advertencia de rojo como en la imagen.

[[Archivo:InformaciondeGuia.png|borde|izquierda|miniaturadeimagen|516x516px|Información del Traslado]]
 

Una vez llenado todos los campos necesarios, tienes la opción de dar una vista previa al
documento antes de emitirse y verificar que todo este correcto. Para emitir la guía, dar clic en
Generar documento.
[[Archivo:VistaPrevia.png|izquierda|miniaturadeimagen|500x500px|Vista Previa de Guías de Remisión]]

 
[[Archivo:ListadoDocumentos.png|izquierda|miniaturadeimagen|500x500px|Listado de Guías Emitidas]]
El sistema le redirigirá a una lista de documentos emitidos por usted, ahí podrá ver sus guías.
 
En la parte de estatus se irá viendo el progreso actual de la guía: enviando, aceptada o con errores.
 
Si hay algún error que retorne Sunat, aparecerá ahí, haga clic en la palabra con errores para ver el
numeró y descripción del error, si no puede solucionarlo contacte con el área correspondiente
para su atención, adjuntando un pantallazo del error.

 
[[Archivo:Acciones.png|izquierda|miniaturadeimagen|500x500px|Acciones del Documento]]
En la parte de Acciones, dar clic en la rueda para ver más detalles de la guía.

 

Aquí se puede obtener el pdf, xml, cdr de la guía, enviar un correo a una o varias personas,
también ver el historial de envíos de correo o añadir información adicional al pdf de la guía ya
emitida para visualización de su cliente.
Para enviar correo a varias personas coloque los correos separados por “;”, como en la siguiente
imagen.

Manual de Uso - Portal - Guias de Remision

2024-04-10T20:38:18Z

Peraltaa: /* ¿Cómo emitir Guías de Remisión 2.0? */

== ¿Cómo ingreso al portal de emisión? ==

-Ingresar a la URL inicial https://demofactura.thefactoryhka.com.pe e ingresar credenciales
en el formulario. Generalmente las credenciales brindadas por su asesor de integraciones es
el RUC para ambas, usuario y contraseña.
 
-Haz clic en Ingresar. 

[[Archivo:Ingresar.png|izquierda|miniaturadeimagen|Imagen: Botón Ingresar - Ambiente Demo]] 

Si el ingreso es exitoso aparecerá el Dashboard del Portal.

[[Archivo:Dashboard.png|izquierda|miniaturadeimagen|Dashboard - Portal de Emisión]]
 

==Requisitos previos para emitir Guías==
=== [https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de datos fiscales] ===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Logotipo Configuración del Logotipo]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de Series]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Sucursales Configuración de Sucursal]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Unidades_de_Medida Agregar Unidades de Medida y Productos]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Clientes Agregar Clientes]===
Si es un cliente PSE es necesario vincular a The Factory como Proveedor de Servicios electrónicos.
===[https://felwiki.thefactoryhka.com.pe/index.php/%C2%BFC%C3%B3mo_vincular_a_The_Factory_HKA_como_PSE%3F Asociación PSE] ===
Si no es un cliente PSE y firma su propio documento , deberá realizar lo siguiente :
===[https://felwiki.thefactoryhka.com.pe/index.php/Cargar_Certificado_Digital_propio Vinculación de Certificado Digital Propio] ===
===[https://cpe.sunat.gob.pe/sites/default/files/inline-files/Manual_Servicios_GRE%20%281%29.pdf Generar Credenciales API SUNAT] ===
[[Archivo:CredencialApiSunat.png|borde|centro|miniaturadeimagen|800x800px|Credenciales API SUNAT]]
Luego de obtener las credenciales API SUNAT para la emisión de Guías de Remisión , deben de registrarlo en el portal de THE FACTORY
 
Una vez hecho exitosamente estos 7 pasos ya podemos emitir guías de remisión
electrónicas.

 
 
== ¿Cómo emitir Guías de Remisión 2.0? ==

Diríjase a la sección de documentos emitidos en documentos => documentos emitidos,
desplegar la flecha a lado de Nuevo Documento y dar clic en Nueva Guía de Remisión.
[[Archivo:EmitiGuia.png|borde|izquierda|miniaturadeimagen|700x700px|Emisión de Guías de Remisión]]
 
 

Luego en la vista generada, Si va generar una guía de remisión - remitente, asegúrese de elegir Guía Remitente 
También asegúrese de seleccionar una serie que fue creada anteriormente para la guía
correspondiente.
[[Archivo:DatosdeGuia.png|izquierda|miniaturadeimagen|655x655px|Información del Documento]]
 

Con respecto al llenado del cliente (destinatario), escribir las 3 primeras letras del cliente ya
registrado previamente para que el sistema automáticamente le de sugerencias de clientes con
esas iniciales, clic en el cliente deseado y se añadirá. El mismo procedimiento es para conceptos
(bienes a transportar).
[[Archivo:Destinatario Guia.png|izquierda|miniaturadeimagen|626x626px|Información del Cliente]]
 

Luego llenar los datos correspondientes a la guía, se dará cuenta de que datos son obligatorios
cuando le dé al botón Vista Previa (parte inferior de la página), en la descripción del popup que
aparecerá dirá que es lo faltante, también en algunos de los campos faltantes aparecerá una
advertencia de rojo como en la imagen.

[[Archivo:InformaciondeGuia.png|borde|izquierda|miniaturadeimagen|516x516px|Información del Traslado]]
 

Una vez llenado todos los campos necesarios, tienes la opción de dar una vista previa al
documento antes de emitirse y verificar que todo este correcto. Para emitir la guía, dar clic en
Generar documento.
[[Archivo:VistaPrevia.png|izquierda|miniaturadeimagen|500x500px|Vista Previa de Guías de Remisión]]

 
[[Archivo:ListadoDocumentos.png|izquierda|miniaturadeimagen|500x500px|Listado de Guías Emitidas]]
El sistema le redirigirá a una lista de documentos emitidos por usted, ahí podrá ver sus guías.
 
En la parte de estatus se irá viendo el progreso actual de la guía: enviando, aceptada o con errores.
 
Si hay algún error que retorne Sunat, aparecerá ahí, haga clic en la palabra con errores para ver el
numeró y descripción del error, si no puede solucionarlo contacte con el área correspondiente
para su atención, adjuntando un pantallazo del error.

 
[[Archivo:Acciones.png|izquierda|miniaturadeimagen|500x500px|Acciones del Documento]]
En la parte de Acciones, dar clic en la rueda para ver más detalles de la guía.
 

 

Aquí se puede obtener el pdf, xml, cdr de la guía, enviar un correo a una o varias personas,
también ver el historial de envíos de correo o añadir información adicional al pdf de la guía ya
emitida para visualización de su cliente.
Para enviar correo a varias personas coloque los correos separados por “;”, como en la siguiente
imagen.

Manual de Uso - Portal - Guias de Remision

2024-04-10T20:37:17Z

Peraltaa: /* ¿Cómo emitir Guías de Remisión 2.0? */

== ¿Cómo ingreso al portal de emisión? ==

-Ingresar a la URL inicial https://demofactura.thefactoryhka.com.pe e ingresar credenciales
en el formulario. Generalmente las credenciales brindadas por su asesor de integraciones es
el RUC para ambas, usuario y contraseña.
 
-Haz clic en Ingresar. 

[[Archivo:Ingresar.png|izquierda|miniaturadeimagen|Imagen: Botón Ingresar - Ambiente Demo]] 

Si el ingreso es exitoso aparecerá el Dashboard del Portal.

[[Archivo:Dashboard.png|izquierda|miniaturadeimagen|Dashboard - Portal de Emisión]]
 

==Requisitos previos para emitir Guías==
=== [https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de datos fiscales] ===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Logotipo Configuración del Logotipo]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de Series]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Sucursales Configuración de Sucursal]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Unidades_de_Medida Agregar Unidades de Medida y Productos]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Clientes Agregar Clientes]===
Si es un cliente PSE es necesario vincular a The Factory como Proveedor de Servicios electrónicos.
===[https://felwiki.thefactoryhka.com.pe/index.php/%C2%BFC%C3%B3mo_vincular_a_The_Factory_HKA_como_PSE%3F Asociación PSE] ===
Si no es un cliente PSE y firma su propio documento , deberá realizar lo siguiente :
===[https://felwiki.thefactoryhka.com.pe/index.php/Cargar_Certificado_Digital_propio Vinculación de Certificado Digital Propio] ===
===[https://cpe.sunat.gob.pe/sites/default/files/inline-files/Manual_Servicios_GRE%20%281%29.pdf Generar Credenciales API SUNAT] ===
[[Archivo:CredencialApiSunat.png|borde|centro|miniaturadeimagen|800x800px|Credenciales API SUNAT]]
Luego de obtener las credenciales API SUNAT para la emisión de Guías de Remisión , deben de registrarlo en el portal de THE FACTORY
 
Una vez hecho exitosamente estos 7 pasos ya podemos emitir guías de remisión
electrónicas.

 
 
== ¿Cómo emitir Guías de Remisión 2.0? ==

Diríjase a la sección de documentos emitidos en documentos => documentos emitidos,
desplegar la flecha a lado de Nuevo Documento y dar clic en Nueva Guía de Remisión.
[[Archivo:EmitiGuia.png|borde|izquierda|miniaturadeimagen|700x700px|Emisión de Guías de Remisión]]
 
 

Luego en la vista generada, Si va generar una guía de remisión - remitente, asegúrese de elegir Guía Remitente 
También asegúrese de seleccionar una serie que fue creada anteriormente para la guía
correspondiente.
[[Archivo:DatosdeGuia.png|izquierda|miniaturadeimagen|655x655px|Información del Documento]]
 

Con respecto al llenado del cliente (destinatario), escribir las 3 primeras letras del cliente ya
registrado previamente para que el sistema automáticamente le de sugerencias de clientes con
esas iniciales, clic en el cliente deseado y se añadirá. El mismo procedimiento es para conceptos
(bienes a transportar).
[[Archivo:Destinatario Guia.png|izquierda|miniaturadeimagen|626x626px|Información del Cliente]]
 

 

Luego llenar los datos correspondientes a la guía, se dará cuenta de que datos son obligatorios
cuando le dé al botón Vista Previa (parte inferior de la página), en la descripción del popup que
aparecerá dirá que es lo faltante, también en algunos de los campos faltantes aparecerá una
advertencia de rojo como en la imagen.

[[Archivo:InformaciondeGuia.png|borde|izquierda|miniaturadeimagen|516x516px|Información del Traslado]]
 

Una vez llenado todos los campos necesarios, tienes la opción de dar una vista previa al
documento antes de emitirse y verificar que todo este correcto. Para emitir la guía, dar clic en
Generar documento.
[[Archivo:VistaPrevia.png|izquierda|miniaturadeimagen|500x500px|Vista Previa de Guías de Remisión]]

 
[[Archivo:ListadoDocumentos.png|izquierda|miniaturadeimagen|500x500px|Listado de Guías Emitidas]]
El sistema le redirigirá a una lista de documentos emitidos por usted, ahí podrá ver sus guías.
 
En la parte de estatus se irá viendo el progreso actual de la guía: enviando, aceptada o con errores.
 
Si hay algún error que retorne Sunat, aparecerá ahí, haga clic en la palabra con errores para ver el
numeró y descripción del error, si no puede solucionarlo contacte con el área correspondiente
para su atención, adjuntando un pantallazo del error.

 
[[Archivo:Acciones.png|izquierda|miniaturadeimagen|500x500px|Acciones del Documento]]
En la parte de Acciones, dar clic en la rueda para ver más detalles de la guía.
 

 

Aquí se puede obtener el pdf, xml, cdr de la guía, enviar un correo a una o varias personas,
también ver el historial de envíos de correo o añadir información adicional al pdf de la guía ya
emitida para visualización de su cliente.
Para enviar correo a varias personas coloque los correos separados por “;”, como en la siguiente
imagen.

Manual de Uso - Portal - Guias de Remision

2024-04-10T20:36:16Z

Peraltaa:

== ¿Cómo ingreso al portal de emisión? ==

-Ingresar a la URL inicial https://demofactura.thefactoryhka.com.pe e ingresar credenciales
en el formulario. Generalmente las credenciales brindadas por su asesor de integraciones es
el RUC para ambas, usuario y contraseña.
 
-Haz clic en Ingresar. 

[[Archivo:Ingresar.png|izquierda|miniaturadeimagen|Imagen: Botón Ingresar - Ambiente Demo]] 

Si el ingreso es exitoso aparecerá el Dashboard del Portal.

[[Archivo:Dashboard.png|izquierda|miniaturadeimagen|Dashboard - Portal de Emisión]]
 

==Requisitos previos para emitir Guías==
=== [https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de datos fiscales] ===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Logotipo Configuración del Logotipo]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de Series]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Sucursales Configuración de Sucursal]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Unidades_de_Medida Agregar Unidades de Medida y Productos]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Clientes Agregar Clientes]===
Si es un cliente PSE es necesario vincular a The Factory como Proveedor de Servicios electrónicos.
===[https://felwiki.thefactoryhka.com.pe/index.php/%C2%BFC%C3%B3mo_vincular_a_The_Factory_HKA_como_PSE%3F Asociación PSE] ===
Si no es un cliente PSE y firma su propio documento , deberá realizar lo siguiente :
===[https://felwiki.thefactoryhka.com.pe/index.php/Cargar_Certificado_Digital_propio Vinculación de Certificado Digital Propio] ===
===[https://cpe.sunat.gob.pe/sites/default/files/inline-files/Manual_Servicios_GRE%20%281%29.pdf Generar Credenciales API SUNAT] ===
[[Archivo:CredencialApiSunat.png|borde|centro|miniaturadeimagen|800x800px|Credenciales API SUNAT]]
Luego de obtener las credenciales API SUNAT para la emisión de Guías de Remisión , deben de registrarlo en el portal de THE FACTORY
 
Una vez hecho exitosamente estos 7 pasos ya podemos emitir guías de remisión
electrónicas.

 
 
== ¿Cómo emitir Guías de Remisión 2.0? ==

Diríjase a la sección de documentos emitidos en documentos => documentos emitidos,
desplegar la flecha a lado de Nuevo Documento y dar clic en Nueva Guía de Remisión.
[[Archivo:EmitiGuia.png|borde|izquierda|miniaturadeimagen|700x700px|Emisión de Guías de Remisión]]
 
 

Luego en la vista generada, Si va generar una guía de remisión - remitente, asegúrese de elegir Guía Remitente 
También asegúrese de seleccionar una serie que fue creada anteriormente para la guía
correspondiente.
[[Archivo:DatosdeGuia.png|izquierda|miniaturadeimagen|655x655px|Información del Documento]]
 

Con respecto al llenado del cliente (destinatario), escribir las 3 primeras letras del cliente ya
registrado previamente para que el sistema automáticamente le de sugerencias de clientes con
esas iniciales, clic en el cliente deseado y se añadirá. El mismo procedimiento es para conceptos
(bienes a transportar).
[[Archivo:Destinatario Guia.png|izquierda|miniaturadeimagen|626x626px|Información del Cliente]]
 

 

Luego llenar los datos correspondientes a la guía, se dará cuenta de que datos son obligatorios
cuando le dé al botón Vista Previa (parte inferior de la página), en la descripción del popup que
aparecerá dirá que es lo faltante, también en algunos de los campos faltantes aparecerá una
advertencia de rojo como en la imagen.

[[Archivo:InformaciondeGuia.png|borde|izquierda|miniaturadeimagen|516x516px|Información del Traslado]]
 

Una vez llenado todos los campos necesarios, tienes la opción de dar una vista previa al
documento antes de emitirse y verificar que todo este correcto. Para emitir la guía, dar clic en
Generar documento.
[[Archivo:VistaPrevia.png|izquierda|miniaturadeimagen|500x500px|Vista Previa de Guías de Remisión]]

 
[[Archivo:ListadoDocumentos.png|izquierda|miniaturadeimagen|500x500px|Listado de Guías Emitidas]]
El sistema le redirigirá a una lista de documentos emitidos por usted, ahí podrá ver sus guías.
 
En la parte de estatus se irá viendo el progreso actual de la guía: enviando, aceptada o con errores.
 
Si hay algún error que retorne Sunat, aparecerá ahí, haga clic en la palabra con errores para ver el
numeró y descripción del error, si no puede solucionarlo contacte con el área correspondiente
para su atención, adjuntando un pantallazo del error.

 
[[Archivo:Acciones.png|izquierda|miniaturadeimagen|500x500px|Acciones del Documento]]
En la parte de Acciones, dar clic en la rueda para ver más detalles de la guía.
 

 

Aquí se puede obtener el pdf, xml, cdr de la guía, enviar un correo a una o varias personas,
también ver el historial de envíos de correo o añadir información adicional al pdf de la guía ya
emitida para visualización de su cliente.
Para enviar correo a varias personas coloque los correos separados por “;”, como en la siguiente
imagen.

Archivo:Acciones.png

2024-04-10T20:35:45Z

Peraltaa:

Acciones

Archivo:ListadoDocumentos.png

2024-04-10T20:34:55Z

Peraltaa:

Listado de Documentos

Archivo:VistaPrevia.png

2024-04-10T20:33:55Z

Peraltaa:

VistaPrevia

Manual de Uso - Portal - Guias de Remision

2024-04-10T20:31:20Z

Peraltaa:

== ¿Cómo ingreso al portal de emisión? ==

-Ingresar a la URL inicial https://demofactura.thefactoryhka.com.pe e ingresar credenciales
en el formulario. Generalmente las credenciales brindadas por su asesor de integraciones es
el RUC para ambas, usuario y contraseña.
 
-Haz clic en Ingresar. 

[[Archivo:Ingresar.png|izquierda|miniaturadeimagen|Imagen: Botón Ingresar - Ambiente Demo]] 

Si el ingreso es exitoso aparecerá el Dashboard del Portal.

[[Archivo:Dashboard.png|izquierda|miniaturadeimagen|Dashboard - Portal de Emisión]]
 

==Requisitos previos para emitir Guías==
=== [https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de datos fiscales] ===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Logotipo Configuración del Logotipo]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de Series]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Sucursales Configuración de Sucursal]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Unidades_de_Medida Agregar Unidades de Medida y Productos]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Clientes Agregar Clientes]===
Si es un cliente PSE es necesario vincular a The Factory como Proveedor de Servicios electrónicos.
===[https://felwiki.thefactoryhka.com.pe/index.php/%C2%BFC%C3%B3mo_vincular_a_The_Factory_HKA_como_PSE%3F Asociación PSE] ===
Si no es un cliente PSE y firma su propio documento , deberá realizar lo siguiente :
===[https://felwiki.thefactoryhka.com.pe/index.php/Cargar_Certificado_Digital_propio Vinculación de Certificado Digital Propio] ===
===[https://cpe.sunat.gob.pe/sites/default/files/inline-files/Manual_Servicios_GRE%20%281%29.pdf Generar Credenciales API SUNAT] ===
[[Archivo:CredencialApiSunat.png|borde|centro|miniaturadeimagen|800x800px|Credenciales API SUNAT]]
Luego de obtener las credenciales API SUNAT para la emisión de Guías de Remisión , deben de registrarlo en el portal de THE FACTORY
 
Una vez hecho exitosamente estos 7 pasos ya podemos emitir guías de remisión
electrónicas.

 
 
== ¿Cómo emitir Guías de Remisión 2.0? ==

Diríjase a la sección de documentos emitidos en documentos => documentos emitidos,
desplegar la flecha a lado de Nuevo Documento y dar clic en Nueva Guía de Remisión.
[[Archivo:EmitiGuia.png|borde|izquierda|miniaturadeimagen|700x700px|Emisión de Guías de Remisión]]
 
 

Luego en la vista generada, Si va generar una guía de remisión - remitente, asegúrese de elegir Guía Remitente 
También asegúrese de seleccionar una serie que fue creada anteriormente para la guía
correspondiente.
[[Archivo:DatosdeGuia.png|izquierda|miniaturadeimagen|284x284px|Información del Documento]]
 

Con respecto al llenado del cliente (destinatario), escribir las 3 primeras letras del cliente ya
registrado previamente para que el sistema automáticamente le de sugerencias de clientes con
esas iniciales, clic en el cliente deseado y se añadirá. El mismo procedimiento es para conceptos
(bienes a transportar).

[[Archivo:Destinatario Guia.png|izquierda|miniaturadeimagen|626x626px|Información del Cliente]]
 

 

Luego llenar los datos correspondientes a la guía, se dará cuenta de que datos son obligatorios
cuando le dé al botón Vista Previa (parte inferior de la página), en la descripción del popup que
aparecerá dirá que es lo faltante, también en algunos de los campos faltantes aparecerá una
advertencia de rojo como en la imagen.

 

Una vez llenado todos los campos necesarios, tienes la opción de dar una vista previa al
documento antes de emitirse y verificar que todo este correcto. Para emitir la guía, dar clic en
Generar documento.

 

El sistema le redirigirá a una lista de documentos emitidos por usted, ahí podrá ver sus guías.
 
En la parte de estatus se irá viendo el progreso actual de la guía: enviando, aceptada o con errores.
 
Si hay algún error que retorne Sunat, aparecerá ahí, haga clic en la palabra con errores para ver el
numeró y descripción del error, si no puede solucionarlo contacte con el área correspondiente
para su atención, adjuntando un pantallazo del error.
 

En la parte de Acciones, dar clic en la rueda para ver más detalles de la guía.
 

 

Aquí se puede obtener el pdf, xml, cdr de la guía, enviar un correo a una o varias personas,
también ver el historial de envíos de correo o añadir información adicional al pdf de la guía ya
emitida para visualización de su cliente.
Para enviar correo a varias personas coloque los correos separados por “;”, como en la siguiente
imagen.

Manual de Uso - Portal - Guias de Remision

2024-04-10T20:30:53Z

Peraltaa: /* ¿Cómo emitir Guías de Remisión 2.0? */

== ¿Cómo ingreso al portal de emisión? ==

-Ingresar a la URL inicial https://demofactura.thefactoryhka.com.pe e ingresar credenciales
en el formulario. Generalmente las credenciales brindadas por su asesor de integraciones es
el RUC para ambas, usuario y contraseña.
 
-Haz clic en Ingresar. 

[[Archivo:Ingresar.png|izquierda|miniaturadeimagen|Imagen: Botón Ingresar - Ambiente Demo]] 

Si el ingreso es exitoso aparecerá el Dashboard del Portal.

[[Archivo:Dashboard.png|izquierda|miniaturadeimagen|Dashboard - Portal de Emisión]]
 

==Requisitos previos para emitir Guías==
=== [https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de datos fiscales] ===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Logotipo Configuración del Logotipo]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de Series]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Sucursales Configuración de Sucursal]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Unidades_de_Medida Agregar Unidades de Medida y Productos]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Clientes Agregar Clientes]===
Si es un cliente PSE es necesario vincular a The Factory como Proveedor de Servicios electrónicos.
===[https://felwiki.thefactoryhka.com.pe/index.php/%C2%BFC%C3%B3mo_vincular_a_The_Factory_HKA_como_PSE%3F Asociación PSE] ===
Si no es un cliente PSE y firma su propio documento , deberá realizar lo siguiente :
===[https://felwiki.thefactoryhka.com.pe/index.php/Cargar_Certificado_Digital_propio Vinculación de Certificado Digital Propio] ===
===[https://cpe.sunat.gob.pe/sites/default/files/inline-files/Manual_Servicios_GRE%20%281%29.pdf Generar Credenciales API SUNAT] ===
[[Archivo:CredencialApiSunat.png|borde|centro|miniaturadeimagen|800x800px|Credenciales API SUNAT]]
Luego de obtener las credenciales API SUNAT para la emisión de Guías de Remisión , deben de registrarlo en el portal de THE FACTORY
 
Una vez hecho exitosamente estos 7 pasos ya podemos emitir guías de remisión
electrónicas.

 
 
== ¿Cómo emitir Guías de Remisión 2.0? ==

Diríjase a la sección de documentos emitidos en documentos => documentos emitidos,
desplegar la flecha a lado de Nuevo Documento y dar clic en Nueva Guía de Remisión.
[[Archivo:EmitiGuia.png|borde|izquierda|miniaturadeimagen|700x700px|Emisión de Guías de Remisión]]
 
 

Luego en la vista generada, Si va generar una guía de remisión - remitente, asegúrese de elegir Guía Remitente 
También asegúrese de seleccionar una serie que fue creada anteriormente para la guía
correspondiente.
[[Archivo:DatosdeGuia.png|izquierda|miniaturadeimagen|284x284px|Información del Documento]]
 

Con respecto al llenado del cliente (destinatario), escribir las 3 primeras letras del cliente ya
registrado previamente para que el sistema automáticamente le de sugerencias de clientes con
esas iniciales, clic en el cliente deseado y se añadirá. El mismo procedimiento es para conceptos
(bienes a transportar).

[[Archivo:Destinatario Guia.png|izquierda|miniaturadeimagen|626x626px|Información del Cliente]]
 

 

Luego llenar los datos correspondientes a la guía, se dará cuenta de que datos son obligatorios
cuando le dé al botón Vista Previa (parte inferior de la página), en la descripción del popup que
aparecerá dirá que es lo faltante, también en algunos de los campos faltantes aparecerá una
advertencia de rojo como en la imagen.

 

Una vez llenado todos los campos necesarios, tienes la opción de dar una vista previa al
documento antes de emitirse y verificar que todo este correcto. Para emitir la guía, dar clic en
Generar documento.

 

El sistema le redirigirá a una lista de documentos emitidos por usted, ahí podrá ver sus guías.
 
En la parte de estatus se irá viendo el progreso actual de la guía: enviando, aceptada o con errores.
 
Si hay algún error que retorne Sunat, aparecerá ahí, haga clic en la palabra con errores para ver el
numeró y descripción del error, si no puede solucionarlo contacte con el área correspondiente
para su atención, adjuntando un pantallazo del error.
 

En la parte de Acciones, dar clic en la rueda para ver más detalles de la guía.
 

 

Aquí se puede obtener el pdf, xml, cdr de la guía, enviar un correo a una o varias personas,
también ver el historial de envíos de correo o añadir información adicional al pdf de la guía ya
emitida para visualización de su cliente.
Para enviar correo a varias personas coloque los correos separados por “;”, como en la siguiente
imagen.

Manual de Uso - Portal - Guias de Remision

2024-04-10T20:30:21Z

Peraltaa: /* ¿Cómo emitir Guías de Remisión 2.0? */

== ¿Cómo ingreso al portal de emisión? ==

-Ingresar a la URL inicial https://demofactura.thefactoryhka.com.pe e ingresar credenciales
en el formulario. Generalmente las credenciales brindadas por su asesor de integraciones es
el RUC para ambas, usuario y contraseña.
 
-Haz clic en Ingresar. 

[[Archivo:Ingresar.png|izquierda|miniaturadeimagen|Imagen: Botón Ingresar - Ambiente Demo]] 

Si el ingreso es exitoso aparecerá el Dashboard del Portal.

[[Archivo:Dashboard.png|izquierda|miniaturadeimagen|Dashboard - Portal de Emisión]]
 

==Requisitos previos para emitir Guías==
=== [https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de datos fiscales] ===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Logotipo Configuración del Logotipo]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de Series]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Sucursales Configuración de Sucursal]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Unidades_de_Medida Agregar Unidades de Medida y Productos]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Clientes Agregar Clientes]===
Si es un cliente PSE es necesario vincular a The Factory como Proveedor de Servicios electrónicos.
===[https://felwiki.thefactoryhka.com.pe/index.php/%C2%BFC%C3%B3mo_vincular_a_The_Factory_HKA_como_PSE%3F Asociación PSE] ===
Si no es un cliente PSE y firma su propio documento , deberá realizar lo siguiente :
===[https://felwiki.thefactoryhka.com.pe/index.php/Cargar_Certificado_Digital_propio Vinculación de Certificado Digital Propio] ===
===[https://cpe.sunat.gob.pe/sites/default/files/inline-files/Manual_Servicios_GRE%20%281%29.pdf Generar Credenciales API SUNAT] ===
[[Archivo:CredencialApiSunat.png|borde|centro|miniaturadeimagen|800x800px|Credenciales API SUNAT]]
Luego de obtener las credenciales API SUNAT para la emisión de Guías de Remisión , deben de registrarlo en el portal de THE FACTORY
 
Una vez hecho exitosamente estos 7 pasos ya podemos emitir guías de remisión
electrónicas.

 
 
== ¿Cómo emitir Guías de Remisión 2.0? ==

Diríjase a la sección de documentos emitidos en documentos => documentos emitidos,
desplegar la flecha a lado de Nuevo Documento y dar clic en Nueva Guía de Remisión.
[[Archivo:EmitiGuia.png|borde|izquierda|miniaturadeimagen|700x700px|Emisión de Guías de Remisión]]
 
 
[[Archivo:DatosdeGuia.png|izquierda|miniaturadeimagen|284x284px|Información del Documento]]
 
Luego en la vista generada, Si va generar una guía de remisión - remitente, asegúrese de elegir Guía Remitente 
También asegúrese de seleccionar una serie que fue creada anteriormente para la guía
correspondiente.

 

 

Con respecto al llenado del cliente (destinatario), escribir las 3 primeras letras del cliente ya
registrado previamente para que el sistema automáticamente le de sugerencias de clientes con
esas iniciales, clic en el cliente deseado y se añadirá. El mismo procedimiento es para conceptos
(bienes a transportar).

[[Archivo:Destinatario Guia.png|izquierda|miniaturadeimagen|626x626px|Información del Cliente]]
 

 

Luego llenar los datos correspondientes a la guía, se dará cuenta de que datos son obligatorios
cuando le dé al botón Vista Previa (parte inferior de la página), en la descripción del popup que
aparecerá dirá que es lo faltante, también en algunos de los campos faltantes aparecerá una
advertencia de rojo como en la imagen.

 

Una vez llenado todos los campos necesarios, tienes la opción de dar una vista previa al
documento antes de emitirse y verificar que todo este correcto. Para emitir la guía, dar clic en
Generar documento.

 

El sistema le redirigirá a una lista de documentos emitidos por usted, ahí podrá ver sus guías.
 
En la parte de estatus se irá viendo el progreso actual de la guía: enviando, aceptada o con errores.
 
Si hay algún error que retorne Sunat, aparecerá ahí, haga clic en la palabra con errores para ver el
numeró y descripción del error, si no puede solucionarlo contacte con el área correspondiente
para su atención, adjuntando un pantallazo del error.
 

En la parte de Acciones, dar clic en la rueda para ver más detalles de la guía.
 

 

Aquí se puede obtener el pdf, xml, cdr de la guía, enviar un correo a una o varias personas,
también ver el historial de envíos de correo o añadir información adicional al pdf de la guía ya
emitida para visualización de su cliente.
Para enviar correo a varias personas coloque los correos separados por “;”, como en la siguiente
imagen.

Manual de Uso - Portal - Guias de Remision

2024-04-10T20:29:24Z

Peraltaa:

== ¿Cómo ingreso al portal de emisión? ==

-Ingresar a la URL inicial https://demofactura.thefactoryhka.com.pe e ingresar credenciales
en el formulario. Generalmente las credenciales brindadas por su asesor de integraciones es
el RUC para ambas, usuario y contraseña.
 
-Haz clic en Ingresar. 

[[Archivo:Ingresar.png|izquierda|miniaturadeimagen|Imagen: Botón Ingresar - Ambiente Demo]] 

Si el ingreso es exitoso aparecerá el Dashboard del Portal.

[[Archivo:Dashboard.png|izquierda|miniaturadeimagen|Dashboard - Portal de Emisión]]
 

==Requisitos previos para emitir Guías==
=== [https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de datos fiscales] ===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Logotipo Configuración del Logotipo]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de Series]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Sucursales Configuración de Sucursal]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Unidades_de_Medida Agregar Unidades de Medida y Productos]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Clientes Agregar Clientes]===
Si es un cliente PSE es necesario vincular a The Factory como Proveedor de Servicios electrónicos.
===[https://felwiki.thefactoryhka.com.pe/index.php/%C2%BFC%C3%B3mo_vincular_a_The_Factory_HKA_como_PSE%3F Asociación PSE] ===
Si no es un cliente PSE y firma su propio documento , deberá realizar lo siguiente :
===[https://felwiki.thefactoryhka.com.pe/index.php/Cargar_Certificado_Digital_propio Vinculación de Certificado Digital Propio] ===
===[https://cpe.sunat.gob.pe/sites/default/files/inline-files/Manual_Servicios_GRE%20%281%29.pdf Generar Credenciales API SUNAT] ===
[[Archivo:CredencialApiSunat.png|borde|centro|miniaturadeimagen|800x800px|Credenciales API SUNAT]]
Luego de obtener las credenciales API SUNAT para la emisión de Guías de Remisión , deben de registrarlo en el portal de THE FACTORY
 
Una vez hecho exitosamente estos 7 pasos ya podemos emitir guías de remisión
electrónicas.

 
 
== ¿Cómo emitir Guías de Remisión 2.0? ==

Diríjase a la sección de documentos emitidos en documentos => documentos emitidos,
desplegar la flecha a lado de Nuevo Documento y dar clic en Nueva Guía de Remisión.
[[Archivo:EmitiGuia.png|borde|izquierda|miniaturadeimagen|700x700px|Emisión de Guías de Remisión]]
 
 
[[Archivo:DatosdeGuia.png|izquierda|miniaturadeimagen|284x284px|Información del Documento]]
Luego en la vista generada, Si va generar una guía de remisión - remitente, asegúrese de elegir Guía Remitente 
También asegúrese de seleccionar una serie que fue creada anteriormente para la guía
correspondiente.

 

 

Con respecto al llenado del cliente (destinatario), escribir las 3 primeras letras del cliente ya
registrado previamente para que el sistema automáticamente le de sugerencias de clientes con
esas iniciales, clic en el cliente deseado y se añadirá. El mismo procedimiento es para conceptos
(bienes a transportar).

[[Archivo:Destinatario Guia.png|izquierda|miniaturadeimagen|626x626px|Información del Cliente]]
 

 

Luego llenar los datos correspondientes a la guía, se dará cuenta de que datos son obligatorios
cuando le dé al botón Vista Previa (parte inferior de la página), en la descripción del popup que
aparecerá dirá que es lo faltante, también en algunos de los campos faltantes aparecerá una
advertencia de rojo como en la imagen.

 

Una vez llenado todos los campos necesarios, tienes la opción de dar una vista previa al
documento antes de emitirse y verificar que todo este correcto. Para emitir la guía, dar clic en
Generar documento.

 

El sistema le redirigirá a una lista de documentos emitidos por usted, ahí podrá ver sus guías.
 
En la parte de estatus se irá viendo el progreso actual de la guía: enviando, aceptada o con errores.
 
Si hay algún error que retorne Sunat, aparecerá ahí, haga clic en la palabra con errores para ver el
numeró y descripción del error, si no puede solucionarlo contacte con el área correspondiente
para su atención, adjuntando un pantallazo del error.
 

En la parte de Acciones, dar clic en la rueda para ver más detalles de la guía.
 

 

Aquí se puede obtener el pdf, xml, cdr de la guía, enviar un correo a una o varias personas,
también ver el historial de envíos de correo o añadir información adicional al pdf de la guía ya
emitida para visualización de su cliente.
Para enviar correo a varias personas coloque los correos separados por “;”, como en la siguiente
imagen.

Manual de Uso - Portal - Guias de Remision

2024-04-10T20:27:57Z

Peraltaa:

== ¿Cómo ingreso al portal de emisión? ==

-Ingresar a la URL inicial https://demofactura.thefactoryhka.com.pe e ingresar credenciales
en el formulario. Generalmente las credenciales brindadas por su asesor de integraciones es
el RUC para ambas, usuario y contraseña.
 
-Haz clic en Ingresar. 

[[Archivo:Ingresar.png|izquierda|miniaturadeimagen|Imagen: Botón Ingresar - Ambiente Demo]] 

Si el ingreso es exitoso aparecerá el Dashboard del Portal.

[[Archivo:Dashboard.png|izquierda|miniaturadeimagen|Dashboard - Portal de Emisión]]
 

==Requisitos previos para emitir Guías==
=== [https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de datos fiscales] ===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Logotipo Configuración del Logotipo]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de Series]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Sucursales Configuración de Sucursal]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Unidades_de_Medida Agregar Unidades de Medida y Productos]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Clientes Agregar Clientes]===
Si es un cliente PSE es necesario vincular a The Factory como Proveedor de Servicios electrónicos.
===[https://felwiki.thefactoryhka.com.pe/index.php/%C2%BFC%C3%B3mo_vincular_a_The_Factory_HKA_como_PSE%3F Asociación PSE] ===
Si no es un cliente PSE y firma su propio documento , deberá realizar lo siguiente :
===[https://felwiki.thefactoryhka.com.pe/index.php/Cargar_Certificado_Digital_propio Vinculación de Certificado Digital Propio] ===
===[https://cpe.sunat.gob.pe/sites/default/files/inline-files/Manual_Servicios_GRE%20%281%29.pdf Generar Credenciales API SUNAT] ===
[[Archivo:CredencialApiSunat.png|borde|centro|miniaturadeimagen|800x800px|Credenciales API SUNAT]]
Luego de obtener las credenciales API SUNAT para la emisión de Guías de Remisión , deben de registrarlo en el portal de THE FACTORY
 
Una vez hecho exitosamente estos 7 pasos ya podemos emitir guías de remisión
electrónicas.

 
 
== ¿Cómo emitir Guías de Remisión 2.0? ==

Diríjase a la sección de documentos emitidos en documentos => documentos emitidos,
desplegar la flecha a lado de Nuevo Documento y dar clic en Nueva Guía de Remisión.
[[Archivo:EmitiGuia.png|borde|izquierda|miniaturadeimagen|700x700px|Emisión de Guías de Remisión]]
 
 
[[Archivo:DatosdeGuia.png|izquierda|miniaturadeimagen|284x284px|Información del Documento]]
Luego en la vista generada, Si va generar una guía de remisión - remitente, asegúrese de elegir Guía Remitente 
También asegúrese de seleccionar una serie que fue creada anteriormente para la guía
correspondiente.

 

 

Con respecto al llenado del cliente (destinatario), escribir las 3 primeras letras del cliente ya
registrado previamente para que el sistema automáticamente le de sugerencias de clientes con
esas iniciales, clic en el cliente deseado y se añadirá. El mismo procedimiento es para conceptos
(bienes a transportar).

[[Archivo:Destinatario Guia.png|izquierda|miniaturadeimagen|626x626px|Información del Cliente]]
 

 

Luego llenar los datos correspondientes a la guía, se dará cuenta de que datos son obligatorios
cuando le dé al botón Vista Previa (parte inferior de la página), en la descripción del popup que
aparecerá dirá que es lo faltante, también en algunos de los campos faltantes aparecerá una
advertencia de rojo como en la imagen.

 

Una vez llenado todos los campos necesarios, tienes la opción de dar una vista previa al
documento antes de emitirse y verificar que todo este correcto. Para emitir la guía, dar clic en
Generar documento.

 

El sistema le redirigirá a una lista de documentos emitidos por usted, ahí podrá ver sus guías.
 
En la parte de estatus se irá viendo el progreso actual de la guía: enviando, aceptada o con errores.
 
Si hay algún error que retorne Sunat, aparecerá ahí, haga clic en la palabra con errores para ver el
numeró y descripción del error, si no puede solucionarlo contacte con el área correspondiente
para su atención, adjuntando un pantallazo del error.
 

En la parte de Acciones, dar clic en la rueda para ver más detalles de la guía.
 

 

Aquí se puede obtener el pdf, xml, cdr de la guía, enviar un correo a una o varias personas,
también ver el historial de envíos de correo o añadir información adicional al pdf de la guía ya
emitida para visualización de su cliente.
Para enviar correo a varias personas coloque los correos separados por “;”, como en la siguiente
imagen.

Archivo:InformaciondeGuia.png

2024-04-10T20:26:45Z

Peraltaa:

Información del Traslado

Archivo:Destinatario Guia.png

2024-04-10T20:24:39Z

Peraltaa:

Destinatario

Archivo:DatosdeGuia.png

2024-04-10T19:52:00Z

Peraltaa:

Datos de la guía de remisión

Manual de Uso - Portal - Guias de Remision

2024-04-10T19:49:26Z

Peraltaa:

== ¿Cómo ingreso al portal de emisión? ==

-Ingresar a la URL inicial https://demofactura.thefactoryhka.com.pe e ingresar credenciales
en el formulario. Generalmente las credenciales brindadas por su asesor de integraciones es
el RUC para ambas, usuario y contraseña.
 
-Haz clic en Ingresar. 

[[Archivo:Ingresar.png|izquierda|miniaturadeimagen|Imagen: Botón Ingresar - Ambiente Demo]] 

Si el ingreso es exitoso aparecerá el Dashboard del Portal.

[[Archivo:Dashboard.png|izquierda|miniaturadeimagen|Dashboard - Portal de Emisión]]
 

==Requisitos previos para emitir Guías==
=== [https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de datos fiscales] ===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Logotipo Configuración del Logotipo]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de Series]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Sucursales Configuración de Sucursal]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Unidades_de_Medida Agregar Unidades de Medida y Productos]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Clientes Agregar Clientes]===
Si es un cliente PSE es necesario vincular a The Factory como Proveedor de Servicios electrónicos.
===[https://felwiki.thefactoryhka.com.pe/index.php/%C2%BFC%C3%B3mo_vincular_a_The_Factory_HKA_como_PSE%3F Asociación PSE] ===
Si no es un cliente PSE y firma su propio documento , deberá realizar lo siguiente :
===[https://felwiki.thefactoryhka.com.pe/index.php/Cargar_Certificado_Digital_propio Vinculación de Certificado Digital Propio] ===
===[https://cpe.sunat.gob.pe/sites/default/files/inline-files/Manual_Servicios_GRE%20%281%29.pdf Generar Credenciales API SUNAT] ===
[[Archivo:CredencialApiSunat.png|borde|centro|miniaturadeimagen|800x800px|Credenciales API SUNAT]]
Luego de obtener las credenciales API SUNAT para la emisión de Guías de Remisión , deben de registrarlo en el portal de THE FACTORY
 

Una vez hecho exitosamente estos 7 pasos ya podemos emitir guías de remisión
electrónicas.

 
 
== ¿Cómo emitir Guías de Remisión 2.0? ==

Diríjase a la sección de documentos emitidos en documentos => documentos emitidos,
desplegar la flecha a lado de Nuevo Documento y dar clic en Nueva Guía de Remisión.
[[Archivo:EmitiGuia.png|borde|izquierda|miniaturadeimagen|700x700px|Emisión de Guías de Remisión]]
 
 

Luego en la vista generada, Si va generar una guía de remisión - remitente, asegúrese de elegir Guía Remitente 
También asegúrese de seleccionar una serie que fue creada anteriormente para la guía
correspondiente.
 

 

Con respecto al llenado del cliente (destinatario), escribir las 3 primeras letras del cliente ya
registrado previamente para que el sistema automáticamente le de sugerencias de clientes con
esas iniciales, clic en el cliente deseado y se añadirá. El mismo procedimiento es para conceptos
(bienes a transportar).

 

Luego llenar los datos correspondientes a la guía, se dará cuenta de que datos son obligatorios
cuando le dé al botón Vista Previa (parte inferior de la página), en la descripción del popup que
aparecerá dirá que es lo faltante, también en algunos de los campos faltantes aparecerá una
advertencia de rojo como en la imagen.

 

Una vez llenado todos los campos necesarios, tienes la opción de dar una vista previa al
documento antes de emitirse y verificar que todo este correcto. Para emitir la guía, dar clic en
Generar documento.

 

El sistema le redirigirá a una lista de documentos emitidos por usted, ahí podrá ver sus guías.
 
En la parte de estatus se irá viendo el progreso actual de la guía: enviando, aceptada o con errores.
 
Si hay algún error que retorne Sunat, aparecerá ahí, haga clic en la palabra con errores para ver el
numeró y descripción del error, si no puede solucionarlo contacte con el área correspondiente
para su atención, adjuntando un pantallazo del error.
 

En la parte de Acciones, dar clic en la rueda para ver más detalles de la guía.
 

 

Aquí se puede obtener el pdf, xml, cdr de la guía, enviar un correo a una o varias personas,
también ver el historial de envíos de correo o añadir información adicional al pdf de la guía ya
emitida para visualización de su cliente.
Para enviar correo a varias personas coloque los correos separados por “;”, como en la siguiente
imagen.

Manual de Uso - Portal - Guias de Remision

2024-04-10T18:32:00Z

Peraltaa:

== ¿Cómo ingreso al portal de emisión? ==

-Ingresar a la URL inicial https://demofactura.thefactoryhka.com.pe e ingresar credenciales
en el formulario. Generalmente las credenciales brindadas por su asesor de integraciones es
el RUC para ambas, usuario y contraseña.
 
-Haz clic en Ingresar. 

[[Archivo:Ingresar.png|izquierda|miniaturadeimagen|Imagen: Botón Ingresar - Ambiente Demo]] 

Si el ingreso es exitoso aparecerá el Dashboard del Portal.

[[Archivo:Dashboard.png|izquierda|miniaturadeimagen|Dashboard - Portal de Emisión]]
 

==Requisitos previos para emitir Guías==
=== [https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de datos fiscales] ===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Logotipo Configuración del Logotipo]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Mi_Cuenta Configuración de Series]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Sucursales Configuración de Sucursal]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n#Unidades_de_Medida Agregar Unidades de Medida y Productos]===
===[https://felwiki.thefactoryhka.com.pe/index.php/Manual_de_Uso_-_Portal_de_Emisi%C3%B3n%23Clientes Agregar Clientes]===
Si es un cliente PSE es necesario vincular a The Factory como Proveedor de Servicios electrónicos.
===[https://felwiki.thefactoryhka.com.pe/index.php/%C2%BFC%C3%B3mo_vincular_a_The_Factory_HKA_como_PSE%3F Asociación PSE] ===
Si no es un cliente PSE y firma su propio documento , deberá realizar lo siguiente :
===[https://felwiki.thefactoryhka.com.pe/index.php/Cargar_Certificado_Digital_propio Vinculación de Certificado Digital Propio] ===
===[https://cpe.sunat.gob.pe/sites/default/files/inline-files/Manual_Servicios_GRE%20%281%29.pdf Generar Credenciales API SUNAT] ===
[[Archivo:CredencialApiSunat.png|borde|centro|miniaturadeimagen|800x800px|Credenciales API SUNAT]]
Luego de obtener las credenciales API SUNAT para la emisión de Guías de Remisión , deben de registrarlo en el portal de THE FACTORY
 

Una vez hecho exitosamente estos 7 pasos ya podemos emitir guías de remisión
electrónicas.

 
 
== ¿Cómo emitir Guías de Remisión 2.0? ==

Diríjase a la sección de documentos emitidos en documentos => documentos emitidos,
desplegar la flecha a lado de Nuevo Documento y dar clic en Nueva Guía de Remisión.
[[Archivo:EmitiGuia.png|borde|izquierda|miniaturadeimagen|700x700px|Emisión de Guías de Remisión]]
 
 

Luego en la vista generada, Si va generar una guía remitente, asegúrese de elegir Guía de
remitente v2 ya que esta cuenta con la versión UBL 2.1 requerida por Sunat y a partir del 7 de
diciembre del 2022, Sunat ya no está aceptando guías de remitente con la primera versión (UBL
1.0).
También asegúrese de seleccionar una serie que fue creada anteriormente para la guía
correspondiente.

 

Con respecto al llenado del cliente (destinatario), escribir las 3 primeras letras del cliente ya
registrado previamente para que el sistema automáticamente le de sugerencias de clientes con
esas iniciales, clic en el cliente deseado y se añadirá. El mismo procedimiento es para conceptos
(bienes a transportar).

 

Luego llenar los datos correspondientes a la guía, se dará cuenta de que datos son obligatorios
cuando le dé al botón Vista Previa (parte inferior de la página), en la descripción del popup que
aparecerá dirá que es lo faltante, también en algunos de los campos faltantes aparecerá una
advertencia de rojo como en la imagen.

 

Una vez llenado todos los campos necesarios, tienes la opción de dar una vista previa al
documento antes de emitirse y verificar que todo este correcto. Para emitir la guía, dar clic en
Generar documento.

 

El sistema le redirigirá a una lista de documentos emitidos por usted, ahí podrá ver sus guías.
 
En la parte de estatus se irá viendo el progreso actual de la guía: enviando, aceptada o con errores.
 
Si hay algún error que retorne Sunat, aparecerá ahí, haga clic en la palabra con errores para ver el
numeró y descripción del error, si no puede solucionarlo contacte con el área correspondiente
para su atención, adjuntando un pantallazo del error.
 
En la parte de Acciones, dar clic en la rueda para ver más detalles de la guía.
 

Aquí se puede obtener el pdf, xml, cdr de la guía, enviar un correo a una o varias personas,
también ver el historial de envíos de correo o añadir información adicional al pdf de la guía ya
emitida para visualización de su cliente.
Para enviar correo a varias personas coloque los correos separados por “;”, como en la siguiente
imagen.

Manual de Uso - Portal - Guias de Remision

2024-04-10T18:27:43Z

Peraltaa:

Archivo:EmitiGuia.png

2024-04-10T18:26:33Z

Peraltaa:

Emisión de Guías

Manual de Uso - Portal - Guias de Remision

2024-04-10T18:25:35Z

Peraltaa:

Archivo:CredencialApiSunat.png

2024-04-10T18:23:33Z

Peraltaa:

Cargar Credencial Api Sunat

Manual de Uso - Portal - Guias de Remision

2024-04-10T18:20:12Z

Peraltaa:

Manual de Uso - Portal - Guias de Remision

2024-04-03T14:49:02Z

Peraltaa:

Manual de Uso - Portal - Guias de Remision

2024-04-03T14:46:57Z

Peraltaa: