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

De Facturacion Electronica de Peru
Ir a la navegación Ir a la búsqueda
 
(No se muestran 60 ediciones intermedias de 4 usuarios)
Línea 53: Línea 53:


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


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


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


===Credenciales===
===CargarCertificado===
----
{| class="wikitable" style="margin: auto;"
! style="text-align:left;"  style="color:red"| Descripción
! ''Método de carga de certificado electrónico en la cuenta del usuario que se usará para firmar electrónicamente los documentos y comprobantes a consignar para OSE/SUNAT.''
|-
! style="text-align:left;"  style="color:red"| Respuesta Exitosa
! ''Código, Mensaje''
|}
 
{| 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
|-
|<!---Campo--->          style="color: blue; text-align:center"| <tem:ruc>
|<!---Descripción--->    RUC del emisor
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>11
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:usuario>
|<!---Descripción--->    Usuario de Integración Emitido por el Sistema
|<!---Tipo|Longitud--->  style="text-align:center;"|
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:clave>
|<!---Descripción--->    Contraseña de Integración Emitido por el Sistema
|<!---Tipo|Longitud--->  style="text-align:center;"|
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:certificadoBase64>
|<!---Descripción--->    Certificado autorizado, cifrado en base 64
|<!---Tipo|Longitud--->  style="text-align:center;"|
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:certificadoClaveBase64>
|<!---Descripción--->    Clave del certificado, cifrada en base 64
|<!---Tipo|Longitud--->  style="text-align:center;"|
|-
|}
 
===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''
|}
 
{| 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
|-
|<!---Campo--->          style="color: blue; text-align:center"| <tem:ruc>
|<!---Descripción--->    RUC del emisor
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>11
|
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:usuario>
|<!---Descripción--->    Usuario de Integración Emitido por el Sistema
|<!---Tipo|Longitud--->  style="text-align:center;"|
|
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:clave>
|<!---Descripción--->    Contraseña de Integración Emitido por el Sistema
|<!---Tipo|Longitud--->  style="text-align:center;"|
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:documento>
|<!---Descripción--->    Tipo, serie y correlativo de documento a dar de baja
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...16
|<!---Formato--->        style="text-align:center;"| TT-XZZZ-NNNNNNNN <br/>
  Donde TT hace referencia al tipo de documento según catálogo N° 01 <br/>
  X hace referencia al tipo de documento: <br/>
  F: Factura o notas asociadas <br/>
  B: Boletas o notas asociadas <br/>
  ZZZ hace referencia a la serie <br/>
  NNNNNNNN hace referencia al correlativo
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:motivo>
|<!---Descripción--->    Motivo de la anulación del documento
|<!---Tipo|Longitud--->  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''
|}
 
{| 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
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:usuario>
|<!---Descripción--->    Usuario de Integración Emitido por el Sistema
|<!---Tipo|Longitud--->  style="text-align:center;"|
|
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:clave>
|<!---Descripción--->    Contraseña de Integración Emitido por el Sistema
|<!---Tipo|Longitud--->  style="text-align:center;"|
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:documento>
|<!---Descripción--->    Tipo, serie y correlativo de documento a dar de baja
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...16
|<!---Formato--->        style="text-align:center;"| TT-XZZZ-NNNNNNNN <br/>
  Donde TT hace referencia al tipo de documento según catálogo N° 01 <br/>
  X hace referencia al tipo de documento: <br/>
  F: Factura o notas asociadas <br/>
  B: Boletas o notas asociadas <br/>
  ZZZ hace referencia a la serie <br/>
  NNNNNNNN hace referencia al correlativo
|-
|<!---Campo--->          style="color: blue; text-align:center"| <tem:tipoArchivo>
|<!---Descripción--->    Tipo de archivo a descargar
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>3
|<!---Formato--->        style="text-align:center;"| PDF: Para descargar el pdf (representación impresa) <br/>
XML: Para descargar el xml (documento electrónico) <br/>
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''
|}
 
{| 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
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:usuario>
|<!---Descripción--->    Usuario de Integración Emitido por el Sistema
|<!---Tipo|Longitud--->  style="text-align:center;"|
|
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:clave>
|<!---Descripción--->    Contraseña de Integración Emitido por el Sistema
|<!---Tipo|Longitud--->  style="text-align:center;"|
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:documento>
|<!---Descripción--->RUC,Tipo, serie y correlativo de documento a consultar
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...16
|<!---Formato--->        style="text-align:center;"| RUC-TT-XZZZ-NNNNNNNN <br/>
  Donde TT hace referencia al tipo de documento según catálogo N° 01 <br/>
  X hace referencia al tipo de documento: <br/>
  ZZZ hace referencia a la serie <br/>
  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''
|}
 
{| style="text-align:left;"
{| style="text-align:left;"
!Ubicación en Objeto:
!Nombre del método
! style="color: blue" | tem:Enviar/
! style="color: blue" | FoliosRestantes
|-
|-
!Cantidad de Campos:
!Cantidad de Campos:
!style="text-align:left;"|3
!style="text-align:left;"|3
|}
{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:ruc>
|<!---Descripción--->    RUC del emisor
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>11
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:usuario>
|<!---Descripción--->    Usuario de Integración Emitido por el Sistema
|<!---Tipo|Longitud--->  style="text-align:center;"|
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:clave>
|<!---Descripción--->    Contraseña de Integración Emitido por el Sistema
|<!---Tipo|Longitud--->  style="text-align:center;"|
|-
|}
===Reversión===
----
{| 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''
|}
{| 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
|-
|<!---Campo--->          style="color: blue; text-align:center"| <tem:ruc>
|<!---Descripción--->    RUC del emisor
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>11
|
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:usuario>
|<!---Descripción--->    Usuario de Integración Emitido por el Sistema
|<!---Tipo|Longitud--->  style="text-align:center;"|
|
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:clave>
|<!---Descripción--->    Contraseña de Integración Emitido por el Sistema
|<!---Tipo|Longitud--->  style="text-align:center;"|
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:documento>
|<!---Descripción--->    Tipo, serie y correlativo de documento a revertir
|<!---Tipo|Longitud--->  style="text-align:center;"| AN<nowiki>|</nowiki>...16
|<!---Formato--->        style="text-align:center;"| TT-XZZZ-NNNNNNNN <br/>
  Donde TT hace referencia al tipo de documento según catálogo N° 01 <br/>
  X hace referencia al tipo de documento: <br/>
  R: Retenciones <br/>
  P: Percepciones <br/>
  ZZZ hace referencia a la serie <br/>
  NNNNNNNN hace referencia al correlativo
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:motivo>
|<!---Descripción--->    Motivo de la anulación del documento
|<!---Tipo|Longitud--->  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''
|}
{| 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
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:ruc>
|<!---Descripción--->    RUC del emisor
|<!---Tipo|Longitud--->  style="text-align:center;"| N<nowiki>|</nowiki>11
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:usuario>
|<!---Descripción--->    Usuario de Integración Emitido por el Sistema
|<!---Tipo|Longitud--->  style="text-align:center;"|
|-
|<!---Campo--->          style="color: blue; text-align:center" | <tem:clave>
|<!---Descripción--->    Contraseña de Integración Emitido por el Sistema
|<!---Tipo|Longitud--->  style="text-align:center;"|
|-
|}
=== 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''
|}
{| 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" <!---Campo---> | <tem:ruc>
|<!---Descripción--->RUC del emisor
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>11
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:usuario>
|<!---Descripción--->Usuario de Integración Emitido por el Sistema
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:clave>
|<!---Descripción--->Contraseña de Integración Emitido por el Sistema
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:tipoCancelar>
|<!---Descripción--->Tipo de listado a cancelar
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
|}
=== 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''
|}
{| 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" <!---Campo---> | <tem:ruc>
|<!---Descripción--->RUC del emisor
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>11
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:usuario>
|<!---Descripción--->Usuario de Integración Emitido por el Sistema
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:clave>
|<!---Descripción--->Contraseña de Integración Emitido por el Sistema
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:extension>
|<!---Descripción--->Extensión de la imagen (jpg, png, ...)
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:logo>
|<!---Descripción--->logo
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
|}
=== 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''
|}
{| 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" <!---Campo---> | <tem:ruc>
|<!---Descripción--->RUC del emisor
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>11
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:usuario>
|<!---Descripción--->Usuario de Integración
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:clave>
|<!---Descripción--->Clave de Integración
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:tipo>
|<!---Descripción--->Tipo de acción a realizar
| style="text-align:center;" <!---Tipo|Longitud---> |Tipo 1: Te permite crear una 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" <!---Campo---> | <per:folio_actual>
|<!---Descripción--->Folio Actual de la Serie
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>8
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:folio_inicial>
|<!---Descripción--->Folio Inicial de la Serie
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>8
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:serie>
|<!---Descripción--->Nomenclatura de la Serie
| style="text-align:center;" <!---Tipo|Longitud---> | AN<nowiki>|</nowiki>4
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:tipo_asignacion>
|<!---Descripción--->Tipo de Asignación Manual o Automático
| style="text-align:center;" <!---Tipo|Longitud---> | A<nowiki>|</nowiki>1
|Automático : A <br> Manual : M
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:tipo_documento>
|<!---Descripción--->Tipo de Documento asociado a la Serie
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>2
| Catálogo N°01
|-
|}
=== 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''
|}
{| 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" <!---Campo---> | <tem:ruc>
|<!---Descripción--->RUC del emisor
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>11
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:token>
|<!---Descripción--->Token de acceso
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:serial>
|<!---Descripción--->Serial del dispositivo
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:tipo>
|<!---Descripción--->Tipo de acción a realizar
| style="text-align:center;" <!---Tipo|Longitud---> |Tipo 1: te permite crear una sucursal
Tipo 2: busca todas las sucursales asociadas a la empresa.
Tipo 3: Actualiza la sucursal por código.
Tipo 4: Borra la sucursal por código.
|-
|}
Datos Sucursal (Objeto / Listado)
{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:codigo>
|<!---Descripción--->código de la sucursal
| style="text-align:center;" <!---Tipo|Longitud---> | string
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:descripcion>
|<!---Descripción--->Descripción de la sucursal
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:direccion>
|<!---Descripción--->Dirección de la sucursal
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:pais>
|<!---Descripción--->Siglas del país Ejemplo: PE
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:telefono>
|<!---Descripción--->Teléfonos de la sucursal
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
| style="color: blue; text-align:center" <!---Campo---> |<tem:tipoEstablecimiento>
|<!---Descripción--->Tipo de establecimiento
|
|-
| style="color: blue; text-align:center" <!---Campo---> |<tem:ubigeo>
|<!---Descripción--->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''
|}
{| 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" <!---Campo---> | <tem:ruc>
|<!---Descripción--->RUC del emisor
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>11
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:usuario>
|<!---Descripción--->Usuario de Integración
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:clave>
|<!---Descripción--->Clave de Integración
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:tipo>
|<!---Descripción--->Tipo de acción a realizar
| style="text-align:center;" <!---Tipo|Longitud---> |Tipo 1: Te permite crear un producto
Tipo 2: Busca todos los productos que posee la empresa.
Tipo 3: Actualiza el producto por códigoUser
Tipo 4: Elimina el producto por códigoUser
|-
|-
!Descripción General:
!style="text-align:left;"|Contiene información para aceptar el documento
|}
|}




{| style="width:100%"
 
! style="width: 50%;"|<!--T:404--> You type
{| class="wikitable" style="margin: auto;"
! style="width: 50%;"|<!--T:405--> You get
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Formato
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:codigoGs1>
|<!---Descripción--->Código GS1 del Producto.
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>13
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:codigoSunat>
|<!---Descripción--->Código Sunat del Producto.
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>8
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:codigoUser>
|<!---Descripción--->Código del Producto que asigna el Usuario internamente.
| style="text-align:center;" <!---Tipo|Longitud---> | AN<nowiki>|</nowiki>30
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:descripcion>
|<!---Descripción--->Descripción del Producto
| style="text-align:center;" <!---Tipo|Longitud---> | AN<nowiki>|</nowiki>500
|
|-
|-
| style="padding: 5px;"|
| style="color: blue; text-align:center" <!---Campo---> | <per:impuesto>
<pre>
|<!---Descripción--->Código de Tipo de Afectación del IGV
{|
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>4
| Naranja
| Catálogo N°07
| Manzana
|-
|-
| Pan
| style="color: blue; text-align:center" <!---Campo---> | <per:unidad>
| Tartaleta
|<!---Descripción--->Unidad de Medida del Producto
| style="text-align:center;" <!---Tipo|Longitud---> |AN<nowiki>|</nowiki>3
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:valorUnitario>
|<!---Descripción--->Valor Unitario del Producto
| style="text-align:center;" <!---Tipo|Longitud---> |12,10
|
|-
|-
| Mantequilla
| Helado
|}
|}
</pre>
 
| style="padding: 5px;"|
=== ListadoClientes===
{|
----
| Orange
{| class="wikitable" style="margin: auto;"
| Apple
! 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.''
|-
|-
| Bread
! style="color:red" | Respuesta Exitosa
| Pie
! ''Código (devuelve 0 si es exitoso), Mensaje''
|}
 
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | ListadoClientes
|-
|-
| Butter
!Cantidad de Campos:
| Ice cream
! style="text-align:left;" |9
|}
|}
{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:ruc>
|<!---Descripción--->RUC del emisor
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>11
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:usuario>
|<!---Descripción--->Usuario de Integración
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:clave>
|<!---Descripción--->Clave de Integración
| style="text-align:center;" <!---Tipo|Longitud---> |
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:tipo>
|<!---Descripción--->Tipo de acción a realizar
| style="text-align:center;" <!---Tipo|Longitud---> |Tipo 1: Te permite crear un 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
|-
|}
|}


==Método ==
 
==Método ==
 
==Método ==
 
{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Formato
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:direccion>
|<!---Descripción--->Dirección
| style="text-align:center;" <!---Tipo|Longitud---> | AN<nowiki>|</nowiki>200
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:email>
|<!---Descripción--->Correo Electrónico del Cliente
| style="text-align:center;" <!---Tipo|Longitud---> | AN<nowiki>|</nowiki>200
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:enviarEmail>
|<!---Descripción--->Activar Notificaciones Via Correo Electrónico
| style="text-align:center;" <!---Tipo|Longitud---> | A<nowiki>|</nowiki>2
|SI o NO
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:numDocumento>
|<!---Descripción--->Número de Documento del Cliente
| style="text-align:center;" <!---Tipo|Longitud---> | AN<nowiki>|</nowiki>15
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:pais>
|<!---Descripción--->País del Cliente
| style="text-align:center;" <!---Tipo|Longitud---> | A<nowiki>|</nowiki>2
|Catálogo N°04
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:razonSocial>
|<!---Descripción--->Razón Social del Cliente
| style="text-align:center;" <!---Tipo|Longitud---> | AN<nowiki>|</nowiki>100
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:telefono>
|<!---Descripción--->Número de Telefono del Cliente
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>15
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:tipoDocumento>
|<!---Descripción--->Tipo de Documento del Cliente
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>2
| Catálogo N°06
|-
| style="color: blue; text-align:center" <!---Campo---> | <per:ubigeo>
|<!---Descripción--->Ubigeo de la Dirección del Cliente
| style="text-align:center;" <!---Tipo|Longitud---> | 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''
|}
 
{| 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" <!---Campo---> | <tem:ruc>
|<!---Descripción--->RUC del emisor
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>11
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:usuario>
|<!---Descripción--->Usuario de Integración
| style="text-align:center;" <!---Tipo|Longitud---> |
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:clave>
|<!---Descripción--->Clave de Integración
| style="text-align:center;" <!---Tipo|Longitud---> |
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:numeracion>
|<!---Descripción--->Numeración del Documento a Enviar
| style="text-align:center;" <!---Tipo|Longitud---> |AN<nowiki>|</nowiki>13
| style="text-align:center;" <!---Formato---> |ZZZZ-NNNNNNNN, donde: <br/>
ZZZZ corresponde a la serie <br/>
NNNNNNNN al número de documento
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:tipo>
|<!---Descripción--->Tipo de Documento
| style="text-align:center;" <!---Tipo|Longitud---> |N<nowiki>|</nowiki>2
| style="text-align:center;" <!---Formato---> |Catálogo N° 06
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:destinatarios>
|<!---Descripción--->Correo electronico del destinatario. Debe ser una dirección válida para el envío correcto del documento electrónico.
Para enviar varios correos, deben separarse con el caracter , (coma) o ; (punto y coma)
| style="text-align:center;" <!---Tipo|Longitud---> |AN<nowiki>|</nowiki>2000
|
|-
|}
 
=== EstatusCorreo===
----
{| class="wikitable" style="margin: auto;"
! style="color:red" | Descripción
! ''Permite realizar una petición para obtener información sobre el historial de envios del documento consultado.''
|-
! style="color:red" | Respuesta Exitosa
! ''Código (devuelve 0 si es exitoso), Mensaje''
|}
 
{| 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" <!---Campo---> | <tem:usuario>
|<!---Descripción--->Usuario de Integración
| style="text-align:center;" <!---Tipo|Longitud---> |
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:clave>
|<!---Descripción--->Clave de Integración
| style="text-align:center;" <!---Tipo|Longitud---> |
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:documento>
|<!---Descripción--->Número de Documento a Consultar
| style="text-align:center;" <!---Tipo|Longitud---> | AN<nowiki>|</nowiki>28
|RUC-TipoDeDocumento-Serie-Correlativo
|-
 
|}
 
 
=== DescargarListado ===
----
{| class="wikitable" style="margin: auto;"
! style="color:red" | Descripción
! ''Permite Descargar los Listados''
|-
! style="color:red" | Respuesta Exitosa
! ''Código (devuelve 0 si es exitoso), Mensaje''
|}
 
{| 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" <!---Campo---> | <tem:ruc>
|<!---Descripción--->RUC del emisor
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>11
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:usuario>
|<!---Descripción--->Usuario de Integración
| style="text-align:center;" <!---Tipo|Longitud---> |
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:clave>
|<!---Descripción--->Clave de Integración
| style="text-align:center;" <!---Tipo|Longitud---> |
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:lote>
|<!---Descripción--->Numeración del lote
| style="text-align:center;" <!---Tipo|Longitud---> |
| style="text-align:center;" <!---Formato---> |
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:ticket>
|<!---Descripción--->numero del ticket (respuesta de GeneraListado)
| style="text-align:center;" <!---Tipo|Longitud---> |
| style="text-align:center;" <!---Formato---> |
|-
|}
 
=== Retención/Percepción ===
{| class="wikitable" style="margin: auto;"
! style="color:red" | Descripción
! ''Permite enviar via correo electrónico los archivos XML,PDF y CDR ''
|-
! style="color:red" | Respuesta Exitosa
! ''Código (devuelve 0 si es exitoso), Mensaje''
|}
 
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | RetencionPercepcion
|-
!Cantidad de Campos:
! style="text-align:left;" |5
|}
''Artículo principal:'' [[Web Service SOAP - Método Retención/Percepción|Web Service SOAP - Método RetenciónPercción]]
{| class="wikitable" style="margin: auto;"
!Campo
!Descripción
!Tipo<nowiki>|</nowiki>Longitud
!Formato
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:ruc>
|<!---Descripción--->RUC del emisor
| style="text-align:center;" <!---Tipo|Longitud---> | N<nowiki>|</nowiki>11
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:usuario>
|<!---Descripción--->Usuario de Integración
| style="text-align:center;" <!---Tipo|Longitud---> |AN
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:clave>
|<!---Descripción--->Clave de Integración
| style="text-align:center;" <!---Tipo|Longitud---> |AN
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:layout>
|<!---Descripción--->Archivo TXT en base64
| style="text-align:center;" <!---Tipo|Longitud---> |AN
| style="text-align:center;" <!---Formato---> |
|-
|}
 
=== Estatus===
----
{| class="wikitable" style="margin: auto;"
! style="color:red" | Descripción
! ''Permite realizar una petición para obtener el estado de las credenciales de integración''
|-
! style="color:red" | Respuesta Exitosa
! ''Código (devuelve 0 si es exitoso), Mensaje''
|}
 
{| style="text-align:left;"
!Nombre del método
! style="color: blue" | Estatus
|-
!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" <!---Campo---> | <tem:ruc>
|<!---Descripción--->Ruc de la empresa
| style="text-align:center;" <!---Tipo|Longitud--->N|11
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:usuario>
|<!---Descripción--->Usuario de Integración
| style="text-align:center;" <!---Tipo|Longitud---> | AN
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:clave>
|<!---Descripción--->Clave de Integración
| style="text-align:center;" <!---Tipo|Longitud---> |AN
|
|-
| style="color: blue; text-align:center" <!---Campo---> | <tem:tipoaplicacion>
|<!---Descripción--->Tipo de aplicación que se consulta
| style="text-align:center;" <!---Tipo|Longitud---> | <nowiki>AN|1</nowiki>
|I
|-
 
|}

Revisión actual del 17:40 10 mar 2025

Proceso

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

Proceso del Modelo Online

Consideraciones

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

Paso a Paso

Enviar un documento electrónico

  • Rellenar objeto de los métodos Enviar o GuiaRemision

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

  • Generar un archivo TXT para el método RetencionPercepcion

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

Conexión para la emisión

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

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

Documentos incluidos en el método RetencionPercepcion:

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

Documentos incluidos en el método GuiaRemision:

  • Guía de Remisión

Conexión para descarga de documentos

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

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

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

Comprantes incluidos para el método ComunicacionBaja:

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

Comprobantes incluidos para el método Reversión:

  • Retención
  • Percepción

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

Métodos del servicio web de The Factory HKA

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

Enviar

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

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

  • Factura Electrónica
  • Boleta de Venta Electrónica
  • Nota de Crédito Electrónica
  • Nota de Débito Electrónica
Descripción Método para enviar documentos (factura, boleta de venta, nota de crédito y nota de débito) a OSE/SUNAT
Respuesta Exitosa Código de aceptación | Mensaje de aceptación | Serie - correlativo del documento y XML timbrado

CargarCertificado

Descripción Método de carga de certificado electrónico en la cuenta del usuario que se usará para firmar electrónicamente los documentos y comprobantes a consignar para OSE/SUNAT.
Respuesta Exitosa Código, Mensaje
Nombre del método CargarCertificado
Cantidad de Campos: 5
Campo Descripción Tipo|Longitud
<tem:ruc> RUC del emisor N|11
<tem:usuario> Usuario de Integración Emitido por el Sistema
<tem:clave> Contraseña de Integración Emitido por el Sistema
<tem:certificadoBase64> Certificado autorizado, cifrado en base 64
<tem:certificadoClaveBase64> Clave del certificado, cifrada en base 64

ComunicacionBaja

Descripción Método para dar de baja a los documentos de venta (factura, boleta de venta, nota de crédito y nota de débito) enviados al OSE/SUNAT
Respuesta Exitosa Código, Mensaje
Nombre del método ComunicacionBaja
Cantidad de Campos: 5
Campo Descripción Tipo|Longitud Formato
<tem:ruc> RUC del emisor N|11
<tem:usuario> Usuario de Integración Emitido por el Sistema
<tem:clave> Contraseña de Integración Emitido por el Sistema
<tem:documento> Tipo, serie y correlativo de documento a dar de baja AN|...16 TT-XZZZ-NNNNNNNN

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

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

DescargaArchivo

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

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

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

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

EstatusDocumento

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

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


FoliosRestantes

Descripción Método para consultarla cantidad de folios restantes para el usuario
Respuesta Exitosa Código, Mensaje
Nombre del método FoliosRestantes
Cantidad de Campos: 3
Campo Descripción Tipo|Longitud
<tem:ruc> RUC del emisor N|11
<tem:usuario> Usuario de Integración Emitido por el Sistema
<tem:clave> Contraseña de Integración Emitido por el Sistema

Reversión

Descripción Método para anular un comprobante de retención o percepción
Respuesta Exitosa Código, Mensaje
Nombre del método Reversion
Cantidad de Campos: 4
Campo Descripción Tipo|Longitud Formato
<tem:ruc> RUC del emisor N|11
<tem:usuario> Usuario de Integración Emitido por el Sistema
<tem:clave> Contraseña de Integración Emitido por el Sistema
<tem:documento> Tipo, serie y correlativo de documento a revertir AN|...16 TT-XZZZ-NNNNNNNN

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

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

ValidaAcceso

Descripción Método para validar las credenciales de acceso
Respuesta Exitosa Código, Mensaje
Nombre del método ValidaAcceso
Cantidad de Campos: 3
Campo Descripción Tipo|Longitud
<tem:ruc> RUC del emisor N|11
<tem:usuario> Usuario de Integración Emitido por el Sistema
<tem:clave> Contraseña de Integración Emitido por el Sistema

GuiasRemision

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

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

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

CancelarListado

Descripción Método para cancelar un listado enviado.
Respuesta Exitosa Código, Mensaje
Nombre del método CancelarListado
Cantidad de Campos: 4
Campo Descripción Tipo|Longitud
<tem:ruc> RUC del emisor N|11
<tem:usuario> Usuario de Integración Emitido por el Sistema
<tem:clave> Contraseña de Integración Emitido por el Sistema
<tem:tipoCancelar> Tipo de listado a cancelar

Descripción Método de carga del logo de la empresa que se usará para generar electrónicamente las representaciones de documentos y comprobantes consignados a OSE/SUNAT.
Respuesta Exitosa Código, Mensaje
Nombre del método Logo
Cantidad de Campos: 5
Campo Descripción Tipo|Longitud
<tem:ruc> RUC del emisor N|11
<tem:usuario> Usuario de Integración Emitido por el Sistema
<tem:clave> Contraseña de Integración Emitido por el Sistema
<tem:extension> Extensión de la imagen (jpg, png, ...)
<tem:logo> logo

ListadoSerie

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

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

Tipo 3: Actualiza la serie por nomenclatura de la serie

Tipo 4: Elimina la serie por nomenclatura de la serie



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

ListadoSucursal

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

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

Tipo 3: Actualiza la sucursal por código.

Tipo 4: Borra la sucursal por código.

Datos Sucursal (Objeto / Listado)

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

ListadoProductos

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

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

Tipo 3: Actualiza el producto por códigoUser

Tipo 4: Elimina el producto por códigoUser


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

ListadoClientes

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

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

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

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



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



EnvioCorreo

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

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

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

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

AN|2000

EstatusCorreo

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


DescargarListado

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

Retención/Percepción

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

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

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

Estatus

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