Integración Directa - Web Service REST - Historial de revisiones

Peraltaa: /* Parámetros de Entrada */

2025-01-24T16:48:47Z

Parámetros de Entrada

← Revisión anterior		Revisión del 16:48 24 ene 2025
Línea 300:		Línea 300:
	\|<!---Descripción---> Tipo, serie y correlativo de documento a consultar		\|<!---Descripción---> Tipo, serie y correlativo de documento a consultar
	\|<!---Tipo\|Longitud---> style="text-align:center;"\| AN<nowiki>\|</nowiki>...16		\|<!---Tipo\|Longitud---> style="text-align:center;"\| AN<nowiki>\|</nowiki>...16
	\|<!---Formato---> style="text-align:center;"\| TT-~~XZZZ~~-NNNNNNNN <br/>		\|<!---Formato---> style="text-align:center;"\| RRRRRRRRRRR-TT-ZZZZ-NNNNNNNN <br/>
	Donde TT hace referencia al ~~tipo de documento según catálogo N° 01~~ <br/>		Donde RRRRRRRRRRR hace referencia al RUC del emisor</br>
	X hace referencia al tipo de documento~~: <br/>~~		TT hace referencia al tipo de documento según catálogo N° 01 <br/>
	~~F: Factura o notas asociadas <br/>~~		ZZZZ hace referencia a la serie <br/>
	~~B: Boletas o notas asociadas~~ <br/>
	~~ZZZ~~ hace referencia a la serie <br/>
	NNNNNNNN hace referencia al correlativo		NNNNNNNN hace referencia al correlativo
	\|-		\|-

Peraltaa: /* DescargaArchivo */

2025-01-24T16:48:15Z

DescargaArchivo

← Revisión anterior		Revisión del 16:48 24 ene 2025
Línea 248:		Línea 248:
	\|<!---Campo---> style="color: blue; text-align:center" \| documento		\|<!---Campo---> style="color: blue; text-align:center" \| documento
	\|<!---Descripción---> Tipo, serie y correlativo de documento a dar de baja		\|<!---Descripción---> Tipo, serie y correlativo de documento a dar de baja
	\|<!---Tipo\|Longitud---> style="text-align:center;"\| AN<nowiki>\|</nowiki>...16		\|<!---Tipo\|Longitud---> style="text-align:center;"\| AN<nowiki>\|</nowiki>...28
	\|<!---Formato---> style="text-align:center;"\| TT-~~XZZZ~~-NNNNNNNN <br/>		\|<!---Formato---> style="text-align:center;"\| RRRRRRRRRRR-TT-ZZZZ-NNNNNNNN <br/>
	Donde TT hace referencia al ~~tipo de documento según catálogo N° 01~~ <br/>		Donde RRRRRRRRRRR hace referencia al RUC del emisor</br>
	X hace referencia al tipo de documento~~: <br/>~~		TT hace referencia al tipo de documento según catálogo N° 01 <br/>
	~~F: Factura o notas asociadas <br/>~~		ZZZZ hace referencia a la serie <br/>
	~~B: Boletas o notas asociadas~~ <br/>
	~~ZZZ~~ hace referencia a la serie <br/>
	NNNNNNNN hace referencia al correlativo		NNNNNNNN hace referencia al correlativo
	\|-		\|-

Silvae en 23:09 6 jul 2023

2023-07-06T23:09:00Z

← Revisión anterior		Revisión del 23:09 6 jul 2023
Línea 109:		Línea 109:
	===Enviar===		===Enviar===

	''Artículo principal:'' [[~~Web_Service_REST_-_Método_Enviar\|~~Web Service REST - Método Enviar]]		==== ''Artículo principal:'' [[Web Service REST - Método Enviar]] ====

	El método '''Enviar''' permite la generación de los siguientes documentos:		El método '''Enviar''' permite la generación de los siguientes documentos:
	* Factura Electrónica		* Factura Electrónica
Línea 374:		Línea 373:

	=== GuiaRemision ===		=== GuiaRemision ===
	~~''Artículo principal:'' [[Web Service REST - Método GuiaRemision]]~~

			==== ''Artículo principal:'' [[Web Service REST - Método GuiaRemision]] ====
	El método '''GuiaRemision''' permite la generación de los siguientes documentos:		El método '''GuiaRemision''' permite la generación de los siguientes documentos:
	* Guía de Remisión Electrónica.		* Guía de Remisión Electrónica.

Silvae en 23:07 6 jul 2023

2023-07-06T23:07:17Z

← Revisión anterior		Revisión del 23:07 6 jul 2023
Línea 58:		Línea 58:
	El enlace de acceso a nuestro ambiente de pruebas es [https://demoint.thefactoryhka.com.pe/Service.svc https://demoint.thefactoryhka.com.pe/Service.svc].		El enlace de acceso a nuestro ambiente de pruebas es [https://demoint.thefactoryhka.com.pe/Service.svc https://demoint.thefactoryhka.com.pe/Service.svc].

	==~~Método~~ Autenticacion==		===Autenticacion===

	{\| class="wikitable" style="margin: auto;"		{\| class="wikitable" style="margin: auto;"
Línea 69:		Línea 69:
	\|}		\|}

	===Parámetros de Entrada===		====Parámetros de Entrada====
	{\| style="text-align:left;"		{\| style="text-align:left;"
	!Nombre del método		!Nombre del método
Línea 107:		Línea 107:


	==~~Método~~ Enviar==		===Enviar===

	''Artículo principal:'' [[Web_Service_REST_-_Método_Enviar\|Web Service REST - Método Enviar]]		''Artículo principal:'' [[Web_Service_REST_-_Método_Enviar\|Web Service REST - Método Enviar]]
Línea 127:		Línea 127:
	\|}		\|}

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

	===Parámetros de Entrada===		====Parámetros de Entrada====
	{\| style="text-align:left;"		{\| style="text-align:left;"
	!Nombre del método		!Nombre del método
Línea 168:		Línea 168:
	\|}		\|}

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

	===Parámetros de Entrada===		====Parámetros de Entrada====
	{\| style="text-align:left;"		{\| style="text-align:left;"
	!Nombre del método		!Nombre del método
Línea 223:		Línea 223:
	\|}		\|}

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

	===Parámetros de Entrada===		====Parámetros de Entrada====
	{\| style="text-align:left;"		{\| style="text-align:left;"
	!Nombre del método		!Nombre del método
Línea 276:		Línea 276:
	\|}		\|}

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

	===Parámetros de Entrada===		====Parámetros de Entrada====
	{\| style="text-align:left;"		{\| style="text-align:left;"
	!Nombre del método		!Nombre del método
Línea 322:		Línea 322:
	\|}		\|}

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

	===Parámetros de Entrada===		====Parámetros de Entrada====
	{\| style="text-align:left;"		{\| style="text-align:left;"
	!Nombre del método		!Nombre del método
Línea 373:		Línea 373:
	\|}		\|}

	== ~~Método Guia de Remisión~~ ==		=== GuiaRemision ===
	''Artículo principal:'' [[Web Service REST - Método GuiaRemision]]		''Artículo principal:'' [[Web Service REST - Método GuiaRemision]]

Silvae: /* Método Guia de Remisión */

2022-10-31T14:29:30Z

Método Guia de Remisión

← Revisión anterior		Revisión del 14:29 31 oct 2022
Línea 374:		Línea 374:

	== Método Guia de Remisión ==		== Método Guia de Remisión ==
	''Artículo principal:'' [[Web Service REST - Método GuiaRemision~~\|Web Service REST - Método Enviar~~]]		''Artículo principal:'' [[Web Service REST - Método GuiaRemision]]

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

Silvae en 14:28 31 oct 2022

2022-10-31T14:28:25Z

← Revisión anterior		Revisión del 14:28 31 oct 2022
Línea 383:		Línea 383:
	{\| class="wikitable" style="margin: auto;"		{\| class="wikitable" style="margin: auto;"
	! style="color:red" \| Descripción		! style="color:red" \| Descripción
	! ''Método para enviar documentos (Guías de Remisión Electrónicas) a ~~OSE/~~SUNAT''		! ''Método para enviar documentos (Guías de Remisión Electrónicas) a SUNAT''
	\|-		\|-
	! style="color:red" \| Respuesta Exitosa		! 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''		! ''Código de aceptación <nowiki>\|</nowiki> Mensaje de aceptación <nowiki>\|</nowiki> Serie - correlativo del documento y XML timbrado''
	\|}		\|}

Silvae en 01:56 29 oct 2022

2022-10-29T01:56:14Z

← Revisión anterior		Revisión del 01:56 29 oct 2022
Línea 322:		Línea 322:
	\|}		\|}

	==Método ~~Reversion~~==		==Método Reversión==
	{\| class="wikitable" style="margin: auto;"		{\| class="wikitable" style="margin: auto;"
	! style="text-align:left;" style="color:red"\| Descripción		! style="text-align:left;" style="color:red"\| Descripción
Línea 371:		Línea 371:
	\|<!---Tipo\|Longitud---> style="text-align:center;"\|		\|<!---Tipo\|Longitud---> style="text-align:center;"\|
	\|-		\|-
			\|}

			== Método Guia de Remisión ==
			''Artículo principal:'' [[Web Service REST - Método GuiaRemision\|Web Service REST - Método Enviar]]

			El método '''GuiaRemision''' permite la generación de los siguientes documentos:
			* Guía de Remisión Electrónica.

			NOTA: El registro de los campos aparece en orden alfabético en este artículo, tal como en el objeto del método

			{\| class="wikitable" style="margin: auto;"
			! style="color:red" \| Descripción
			! ''Método para enviar documentos (Guías de Remisión Electrónicas) 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''
	\|}		\|}

Alejosl: /* Método Enviar */

2021-07-12T21:01:30Z

Método Enviar

← Revisión anterior		Revisión del 21:01 12 jul 2021
Línea 109:		Línea 109:
	==Método Enviar==		==Método Enviar==

	''Artículo principal:'' [[~~Web_Service_SOAP_~~-_Método_Enviar\|Web Service ~~SOAP~~ - Método Enviar]]		''Artículo principal:'' [[Web_Service_REST_-_Método_Enviar\|Web Service REST - Método Enviar]]

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

Alejosl en 20:58 12 jul 2021

2021-07-12T20:58:03Z

Mostrar los cambios

Alejosl: Página creada con «==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…»

2021-07-12T17:59:05Z

Página creada con «==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…»

Página nueva

==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á mediante el envío de un objeto, llenado directamente sobre el request del método '''RetencionPercepcion'''
* Para el consumo de los métodos, los nodos aparecen publicados en forma alfabética

==Paso a Paso==
===Enviar un documento electrónico===

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'''; así como invocar el método '''RetencionPercepcion''' para el envío de los Comprobantes de Retención y/o Percepción.


===Conexión para la emisión===
Antes de realizar cualquier envío, previamente deberá consumirse el método '''Autenticacion''' que generará un token de seguridad, el
cual será utilizado para todos los métodos del servicio. Según sea el caso, se debe invocar el método “Enviar” o “RetencionPercepcion”, ambos disponibles en el WS de '''The Factory HKA'''. El método se debe llenar con el objeto del request para documentos o comprobantes de venta. Este método es el encargado de abrir 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].

==Método Autenticacion==

{| class="wikitable" style="margin: auto;"
! style="text-align:left;" style="color:red"| Descripción
! ''Permite la generación del token de acceso para el consumo del resto de los métodos, tomando como entrada
las credenciales generadas por Integraciones o desde el portal de emisió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" | Autenticacion
|-
!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"| clave
| Contraseña de Integración, emitida por el sistema
| style="text-align:center;"|
|
|-
| style="color: blue; text-align:center" | ruc
| RUC del emisor
| style="text-align:center;"| N<nowiki>|</nowiki>11
|
|-
| style="color: blue; text-align:center" | tipoAplicacion
| Indica el medio de envío. El valor fijo es I, de Integraciones
| style="text-align:center;"|N<nowiki>|</nowiki>1
| style="text-align:center;"| I
|-
| style="color: blue; text-align:center" | usuario
| Usuario de Integración, emitido por el sistema
| style="text-align:center;"|
|
|-
|}

==Método 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

NOTA: El registro de los campos aparece en orden alfabético en este artículo, tal como en el objeto del método

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

==Método 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;"|4
|}

{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
|-
| style="color: blue; text-align:center" | certificadoBase64
| Certificado autorizado, codificado en base 64
| style="text-align:center;"|
|-
| style="color: blue; text-align:center" | certificadoClaveBase64
| Clave del certificado, codificado en base 64
| style="text-align:center;"|
|-
| style="color: blue; text-align:center"| ruc
| RUC del emisor
| style="text-align:center;"| N<nowiki>|</nowiki>11
|-
| style="color: blue; text-align:center" | token
| Token de seguridad, generado en el método Autenticacion
| style="text-align:center;"|
|-
|}

==Método 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
|-
|}

==Método 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
|-
|}

==Método 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'''.''
|-
! 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" | documento
| Tipo, serie y correlativo de documento a consultar
| 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" | ruc
| RUC del emisor
| style="text-align:center;"| N<nowiki>|</nowiki>11
|
|-
| style="color: blue; text-align:center" | token
| Token de seguridad, generado en el método Autenticación
| style="text-align:center;"|
|-
|}

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

==Método 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
|-
|}

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