Diferencia entre revisiones de «Retención Percepción»
Ir a la navegación
Ir a la búsqueda
Línea 19: | Línea 19: | ||
* | * | ||
{| class="wikitable" style="margin: auto;" | {| class="wikitable" style="margin: auto;" | ||
!Campo | !Campo | ||
!Descripción | !Descripción | ||
Línea 27: | Línea 26: | ||
!Opcional | !Opcional | ||
|- | |- | ||
| style="color: blue; text-align:center" <!---Campo---> |<tem:RUC> | | style="color: blue; text-align:center" <!---Campo---> |<tem:RUC> | ||
|<!---Descripción--->RUC del emisor | |<!---Descripción--->RUC del emisor | ||
Línea 35: | Línea 33: | ||
| - | | - | ||
|- | |- | ||
| style="color: blue; text-align:center" <!---Campo---> |<tem:usuario> | | style="color: blue; text-align:center" <!---Campo---> |<tem:usuario> | ||
|<!---Descripción--->Usuario de integración, emitido por el sistema. | |<!---Descripción--->Usuario de integración, emitido por el sistema. | ||
Línea 43: | Línea 40: | ||
| - | | - | ||
|- | |- | ||
| style="color: blue; text-align:center" <!---Campo---> |<tem:clave> | | style="color: blue; text-align:center" <!---Campo---> |<tem:clave> | ||
|<!---Descripción--->Contraseña de integración, emitido por el sistema. | |<!---Descripción--->Contraseña de integración, emitido por el sistema. | ||
Línea 51: | Línea 47: | ||
| - | | - | ||
|- | |- | ||
| style="color: blue; text-align:center" <!---Campo---> |<tem:layout> | | style="color: blue; text-align:center" <!---Campo---> |<tem:layout> | ||
|<!---Descripción--->Archivo adjunto, con formato especifico y cifrado en base64 | |<!---Descripción--->Archivo adjunto, con formato especifico y cifrado en base64 | ||
Línea 57: | Línea 52: | ||
| - | | - | ||
| - | | - | ||
| - | | Anexo A | ||
|} | |||
=== ANEXO A - Layout para Comprobantes de Retención y Comprobantes de Percepción === | |||
{| class="wikitable" | |||
|- | |||
!Descripción General: | |||
!Estructura del archivo TXT a enviar para el consumo del método RetencionPercepcion | |||
Para que el usuario sea capaz de generar un comprobante de retención y percepción electrónico a través de | |||
nuestras aplicaciones, es necesario colocar ciertos datos dentro de un archivo txt, separándolos por el | |||
carácter ‘|’. | |||
Estos datos deben tener un formato y estructura determinada para que puedan ser procesados por la | |||
aplicación. A continuación, se muestran los campos a ingresar: | |||
|} | |||
{| class="wikitable" style="margin: auto;" | |||
! colspan="6" |Línea 1 – Datos del Proveedor | |||
|- | |||
!# | |||
!Campo | |||
!Descripción | |||
!Tipo | |||
!Longitud | |||
!Requerido | |||
|- | |||
|1 | |||
| style="color: blue; text-align:center" <!---Campo---> |Identificador 01 | |||
|<!---Descripción---> | |||
| style="text-align:center;" <!---Tipo|Longitud---> |A | |||
| 2 | |||
| SI | |||
|- | |||
|2 | |||
| style="color: blue; text-align:center" <!---Campo---> |Apellidos y nombres | |||
|<!---Descripción--->Denominación o razón social del proveedor | |||
| style="text-align:center;" <!---Tipo|Longitud---> |AN | |||
| 100 | |||
| SI | |||
|- | |||
|3 | |||
| style="color: blue; text-align:center" <!---Campo---> |N° de documento de identidad | |||
del proveedor y Tipo | |||
|<!---Descripción--->Debe basarse en el Catálogo 6. Se deben separar los datos por un | |||
/ (Ejemplo: 20550728762/6). | |||
| style="text-align:center;" <!---Tipo|Longitud---> |AN | |||
| 15 | |||
| SI | |||
|- | |||
|4 | |||
| style="color: blue; text-align:center" <!---Campo---> |Email | |||
|<!---Descripción--->Sólo debe llenar este campo si coloca “SI” en la columna | |||
12Notificar. | |||
| style="text-align:center;" <!---Tipo|Longitud---> |AN | |||
| 50 | |||
| NO | |||
|- | |||
|5 | |||
|Número de teléfono | |||
|<!---Descripción--->Indicar el número de teléfono del proveedor si lo tuviese. | |||
|N | |||
|50 | |||
|NO | |||
|- | |||
|6 | |||
|Ubigeo | |||
|<!---Descripción--->Consignar el código de UBIGEO de la ubicación geográfica de la | |||
Razón social del proveedor Ejemplo: 150122 | |||
|AN | |||
|6 | |||
|NO | |||
|- | |||
|7 | |||
|Direccion | |||
|<!---Descripción--->Colocar la dirección Fiscal de la Razón Social del Proveedor | |||
|AN | |||
|100 | |||
|NO | |||
|- | |||
|8 | |||
|Urbanización | |||
|<!---Descripción--->Colocar la Urbanización de la dirección Fiscal de la Razón Social | |||
del Proveedor | |||
|AN | |||
|50 | |||
|NO | |||
|- | |||
|9 | |||
|Provincia | |||
|<!---Descripción--->Colocar la Provincia de la dirección Fiscal de la Razón Social del | |||
proveedor | |||
|AN | |||
|50 | |||
|NO | |||
|- | |||
|10 | |||
|Departamento | |||
|<!---Descripción--->Colocar el Departamento de la Ubicación Fiscal de la Razón Social | |||
del Proveedor | |||
|AN | |||
|50 | |||
|NO | |||
|- | |||
|11 | |||
|Distrito | |||
|<!---Descripción--->Indicar el Distrito de la dirección Fiscal de la razón social del | |||
proveedor | |||
|AN | |||
|50 | |||
|NO | |||
|- | |||
|12 | |||
|País | |||
|<!---Descripción--->Por ejemplo, PE para Perú. | |||
|AN | |||
|50 | |||
|NO | |||
|- | |||
|13 | |||
|Notificar | |||
|<!---Descripción--->Colocar SI cuando requiera enviar por correo los documentos | |||
emitidos. El envío se realizará a la dirección anotada en el campo | |||
4-Email. Si coloca NO, no se realizarán los envíos | |||
|AN | |||
|2 | |||
|NO | |||
|} | |} |
Revisión del 22:52 6 sep 2023
Enviar un documento ELECTRÓNICO DE RETENCIÓN O PERCEPCIÓN
- GENERAR UN TXT PARA EL METODO “RetencionPercepcion” Para enviar un comprabante de Retención o Percepción es necesario que su sistema genere un archivo TXT con un layout especifico, descrito en los Anexos A y B.
CONEXIÓN PARA EMISIÓN
- Se debe invocar el método "RetencionPercecion", disponible en el Servicioi 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. 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 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 “RetencionPercepcion”: * Comprobante de Retención * Comprobante de Percepción
RETENCIÓN | PERCEPCIÓN
Nombre del metodo | RetencionPercepcion |
---|---|
Cantidad de campos en línea: | 4 |
Descripción General: | Contiene la información del archivo adjunto para la carga de las retenciones y percepciones |
Campo | Descripción | Tipo|Longitud | Formato | Obligatorio | Opcional |
---|---|---|---|---|---|
<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:layout> | Archivo adjunto, con formato especifico y cifrado en base64 | - | - | Anexo A |
ANEXO A - Layout para Comprobantes de Retención y Comprobantes de Percepción
Descripción General: | Estructura del archivo TXT a enviar para el consumo del método RetencionPercepcion
Para que el usuario sea capaz de generar un comprobante de retención y percepción electrónico a través de nuestras aplicaciones, es necesario colocar ciertos datos dentro de un archivo txt, separándolos por el carácter ‘|’. Estos datos deben tener un formato y estructura determinada para que puedan ser procesados por la aplicación. A continuación, se muestran los campos a ingresar: |
---|
Línea 1 – Datos del Proveedor | |||||
---|---|---|---|---|---|
# | Campo | Descripción | Tipo | Longitud | Requerido |
1 | Identificador 01 | A | 2 | SI | |
2 | Apellidos y nombres | Denominación o razón social del proveedor | AN | 100 | SI |
3 | N° de documento de identidad
del proveedor y Tipo |
Debe basarse en el Catálogo 6. Se deben separar los datos por un
/ (Ejemplo: 20550728762/6). |
AN | 15 | SI |
4 | Sólo debe llenar este campo si coloca “SI” en la columna
12Notificar. |
AN | 50 | NO | |
5 | Número de teléfono | Indicar el número de teléfono del proveedor si lo tuviese. | N | 50 | NO |
6 | Ubigeo | Consignar el código de UBIGEO de la ubicación geográfica de la
Razón social del proveedor Ejemplo: 150122 |
AN | 6 | NO |
7 | Direccion | Colocar la dirección Fiscal de la Razón Social del Proveedor | AN | 100 | NO |
8 | Urbanización | Colocar la Urbanización de la dirección Fiscal de la Razón Social
del Proveedor |
AN | 50 | NO |
9 | Provincia | Colocar la Provincia de la dirección Fiscal de la Razón Social del
proveedor |
AN | 50 | NO |
10 | Departamento | Colocar el Departamento de la Ubicación Fiscal de la Razón Social
del Proveedor |
AN | 50 | NO |
11 | Distrito | Indicar el Distrito de la dirección Fiscal de la razón social del
proveedor |
AN | 50 | NO |
12 | País | Por ejemplo, PE para Perú. | AN | 50 | NO |
13 | Notificar | Colocar SI cuando requiera enviar por correo los documentos
emitidos. El envío se realizará a la dirección anotada en el campo 4-Email. Si coloca NO, no se realizarán los envíos |
AN | 2 | NO |