Web Service SOAP - Método Retención/Percepción

Enviar un documento ELECTRÓNICO DE RETENCIÓN O PERCEPCIÓN

• GENERAR UN TXT PARA EL METODO “RetencionPercepcion” Para enviar un comprobante 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 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. 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	Email	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

Línea 2 – Datos De la Retención del CRE
#	Campo	Descripción	Tipo	Longitud	Requerido
1	Identificador 02		A	2	SI
2	Fecha de Emisión del Documento	Formato YYYY-MM-DD	AN	10	SI
3	Tipo de documento	Indicar el valor 20	AN	2	SI
4	Serie y correlativo del documento	El correlativo es manejado por DFACTURE, en esos casos sólo debe enviar la serie (Ejemplo: R001). Si usted desea manejarlo, debe enviar ambos campos separados con un guion (Ejemplo: R001-0000001).	AN	13	SI
5	Régimen de Retención	Corresponde al régimen de retención aplicable al comprobante de retención electrónico. A continuación, se especifica el valor que puede declarar: ES 01	N	2	SI
6	Tasa de Retención	Corresponde a la tasa de retención aplicable al comprobante de retención electrónico. A continuación se especifica el valor que puede declarar es 3.00	N	12.2	SI
7	Importe Total Retenido	Importe total retenido del Comprobante de Retención Electrónico. Este importe siempre es en Nuevos soles. Este valor debe ser igual a la suma a los importes retenidos (campo importe retenido) por cada comprobante relacionado	N	12.2	SI
8	Importe Total Pagado	Importe total pagado del Comprobante de Retención Electrónico. Este importe siempre es en Nuevos soles. Este valor deber ser igual a la suma de los montos totales pagados (Importe Total a Pagar Neto) por cada comprobante relacionado	N	12.2	SI
9	Observaciones	Notas u observaciones para la emisión del comprobante de retención electrónico	AN	250	NO

Línea 1 – Datos del Proveedor
#	Campo	Descripción	Tipo	Longitud	Requerido
1	Identificador 03		A	2	SI
2	Tipo, Serie y Numero de Documento Relacionado	Código del tipo de documento, solo para lo siguiente: 01- FACT-1 - 01 FACTURA - 07 NOTA DE CREDITO - 08 NOTA DE DEBITO - 12 TICKET MAQUINA REGISTRADORA	AN	22	SI
3	Fecha de Emisión Documento Relacionado	Corresponde a la fecha de emisión del documento relacionado	AN	10	SI
4	Importe Total Documento Relacionado	Importe total del comprobante relacionado en moneda original	N	12.2	SI
5	Tipo de Moneda Documento Relacionado	Moneda utilizada en el comprobante relacionado	AN	3	SI
6	Fecha del Pago	Corresponde a la fecha de pago del documento relacionado	AN	10	SI
7	Número del pago	Corresponde al número correlativo de pago, utilizado para pagos parciales. Si fuera un único pago deberá indicar 1. Este valor no se puede repetir para un mismo comprobante relacionado	N	9	SI
8	Importe de Pago sin Retención	Importe de pago en moneda original, no incluye la retención. Debe indicarse en la misma moneda del importe total del comprobante relacionado. El importe de pago no debe ser mayor al importe total del comprobante relacionado	N	12.2	SI
9	Moneda de Pago	Moneda del importe de pago	AN	3	SI
10	Importe Retenido	Importe de la retención en moneda nacional	N	12.2	SI
11	Fecha de Retención	Corresponde a la fecha de retención asociada documento relacionado	AN	3	NO
12	Importe Total a Pagar (neto)	Monto total pagado en moneda nacional incluida la retención.	N	12.2	NO
13	Moneda de referencia para el tipo de cambio	Moneda de referencia para el tipo de cambio. Si la moneda utilizada en el comprobante relacionado (campo Tipo de Moneda Documento relacionado) es diferente de PEN (Soles), los campos de tipo de cambio son obligatorios.	AN	3	NO
14	Moneda objetivo para la tasa de cambio	La moneda objetivo para la tasa de cambio. Por defecto debe ser PEN (Soles)	AN	3	NO
15	El factor aplicado a la moneda de origen para calcular la moneda destino (tipo de cambio)	El tipo de cambio aplicado a la moneda de origen (tipo de cambio). Ejemplo 3.000	N	5.3	NO
16	Fecha de Cambio	Indicar la fecha aplicada para el tipo de cambio. Esta fecha corresponde a la fecha de pago. (Solo es Obligatorio cuando se consigna una de retención en Dólares).	AN	10	NO

Ejemplo:

0A|MANUAL|

01|PERU TRADER S.A.C.|20520708996/6|||150101|AV. SANTA MARIA NO. 150 URB. IND. LA AURORA - ATE|||||PE|NO|

02|2017-03-15|20|RPL7-00000026|01|3.00|11.33|366.21|CRE R001-00000149 - PROVEEDOR: PERU TRADER S.A.C. - RPP-2017-02-000475|

03|01-0001-00027553|2016-12-21|377.54|PEN|2017-02-23|1|377.54|PEN|11.33|2017-02-23|366.21|||||