Nubefact Doc Api TXT V1

INTEGRACIÓN FÁCIL CON ARCHIVO TXT
Para consultas escribir a [email protected] o al WhatsApp 924 353365
MANUAL DE INTEGRACIÓN
ARCHIVO .TXT
FUNCIONA PARA VERSIÓN ONLINE, OFFLINE Y REVENDEDOR(RESELLER) Actualizado al 31/07/2019
MANUAL para archivo JSON en el link: https://goo.gl/WHMmSb
FECHA VERSIÓN DE ESTE DOCUMENTO DETALLE
4/05/2017 1.1 Nuevas estructuras, archivo TXT.
Generar para contingencia (Comunicar facturas físicas emitidas como medida de

10/10/2018 1.2
Contingencia).
5/12/2018 1.3 Código de Producto SUNAT.
24/12/2018 1.4 Crear cuenta para DEMO
10/03/2019 1.5 Enlace de PDF, XML Y CDR en las respuestas.
19/07/2019 1.6 Operación Sujeta a Detracción y Detracción Servicios de Transporte Carga
17/09/2019 1.7 Agregado Tipo de Detraccion: 001, 003, 019, 020, 022, 025, 027
28/10/2019 1.8 Agregado Tipo de operación: Operación Sujeta a Percepción
30/03/2020 1.9 Agregado IVAP
11/04/2020 2.0 Agregados nuevos tipos de Detracción
15/04/2020 2.1 Agregado Medios de Pago para operaciones de Detracciones
Operación Sujeta a Detracción Servicios de Transporte de Pasajeros y Detracción de Recursos

22/05/2020 2.2
Hidrobiológicos.
ÍNDICE
ÍNDICE 1
INTRODUCCIÓN 2
VERSIONES DE NUBEFACT PARA USAR NUESTRA API. 2
FORMATOS O ARCHIVOS SOPORTADOS 2
AUTENTICACIÓN 2
CUENTA DEMO PARA HACER PRUEBAS 2
CONSEGUIR UNA CUENTA EN NUBEFACT 2
CÓMO USAR LA RUTA Y EL TOKEN 2
HERRAMIENTAS PARA LA RUTA Y EL TOKEN: 3
FORMA DE TRABAJO 3
CONSTRUIR UN ARCHIVO TXT 3

TIPOS DE DATOS 3
OPERACIÓN 1: GENERAR FACTURAS, BOLETAS Y NOTAS CON TXT 3
OPERACIÓN 2: CONSULTAR FACTURAS, BOLETAS Y NOTAS CON TXT 4
OPERACIÓN 3: ANULAR FACTURAS, BOLETAS Y NOTAS CON TXT 4
OPERACIÓN 4: CONSULTAR ANULACIÓN DE FACTURAS, BOLETAS Y NOTAS CON TXT 5
EJEMPLOS DE ARCHIVOS TXT 5
REPRESENTACIÓN IMPRESA 5
EJEMPLOS DE CÓDIGO EN LENGUAJES DE PROGRAMACIÓN 6

PHP 6
C# 6
JAVA 6
VB.NET 6
VISUAL BASIC 6 6
VISUAL FOX PRO 6
PASAR A PRODUCCIÓN 6
ESTRUCTURA DE ARCHIVOS TXT 7

ESTRUCTURA PARA GENERAR FACTURAS, BOLETAS Y NOTAS 7
ESTRUCTURA PARA CONSULTAR FACTURAS, BOLETAS Y NOTAS 11
ESTRUCTURA DE RESPUESTA DE NUBEFACT PARA FACTURAS, BOLETAS, NOTAS 11
ESTRUCTURA PARA GENERAR ANULACIÓN O COMUNICACIÓN DE BAJA 12
ESTRUCTURA PARA CONSULTAR ANULACIÓN O COMUNICACIÓN DE BAJA 12
ESTRUCTURA DE LA RESPUESTA DE NUBEFACT PARA ANULACIÓN O COMUNICACIÓN DE BAJA 13
INTRODUCCIÓN
NUBEFACT es una empresa autorizada por la SUNAT para emitir documentos electrónicos.
Sin importar el lenguaje de programación que uses puedes consumir nuestra API vía ONLINE y OFFLINE para emitir documentos electrónicos
autorizados en cuestión de minutos.
Proporcionamos soporte para la integración y contamos con ejemplos al final de este documento para los lenguajes de programación más solicitados:
PHP, JAVA, C#, VB.NET, VISUAL BASIC, VISUAL FOXPRO, RUBY, etc., en realidad cualquier lenguaje de programación podría integrarse con
nosotros, ya que usamos archivos de texto ligeros para la integración como son el JSON y TXT.
VERSIONES DE NUBEFACT PARA USAR NUESTRA API.

Esta documentación es para ambas versiones a menos que se indique lo contrario.
● VERSIÓN ONLINE: Puedes integrar tu aplicación usando nuestra WEB SERVICE (API REST). Consumes directamente nuestra WEB
SERVICE publicada en www.nubefact.com. Es necesario contar con internet para generar el documento.
● VERSIÓN OFFLINE: Puedes integrar tu aplicación usando nuestra WEB SERVICE (API REST). Instalamos nuestra aplicación en el servidor
o PC de la empresa para que consumas nuestra WEB SERVICE vía LOCALHOST. NO es necesario contar con internet para generar el
documento.
FORMATOS O ARCHIVOS SOPORTADOS

Actualmente soportamos archivos JSON y TXT, tanto para la solicitud como para la respuesta.
● MANUAL para archivo JSON en el link: https://goo.gl/WHMmSb
● MANUAL para archivo TXT en el link: https://goo.gl/Lz7hAq
AUTENTICACIÓN
Nuestro servicio está protegido para evitar intrusos.
Lo primero que debes saber es que para usar nuestra API debes autenticarte o loguearte. Para ello necesitas DOS datos: una RUTA y un TOKEN.
RUTA: Cada cliente tiene una RUTA distinta y única.

● EJEMPLO (Versión ONLINE): https://www.nubefact.com/api/v1/48239908-7ae7-4353-824d-071765d4
● EJEMPLO (Versión OFFLINE): http://localhost:8000/api/v1/48239908-7ae7-4353-824d-071765d4
TOKEN: Puedes tener uno o varios TOKEN.
● EJEMPLO: 1c4239064a3f441880d7ced75eea4383b831c0bf26944169b
Estos datos los podemos conseguir en tu cuenta en NUBEFACT.
CONSEGUIR UNA CUENTA DEMO EN NUBEFACT

Sigue los siguiente pasos:
● Regístrate gratis en www.nubefact.com/register
● Ir la opción API (Integración). Si la opción API (Integración) no está activada necesitas escribirnos a [email protected] o llámanos al
teléfono: 01 468 3535 (opción 2) o celular (WhatsApp) 955 598762.
CÓMO USAR LA RUTA Y EL TOKEN

Para usar la RUTA y el TOKEN tener en cuenta lo siguiente:
1. Todas las solicitudes se hacen vía POST a la RUTA, ejemplo: https://www.nubefact.com/api/v1/48239908-7ae7-071765d4

2. Debes enviar en el HEADER de tu solicitud la siguiente lo siguiente:
Authorization 8d19d8c7c1f6402687720eab85cd57a54f5a7a3fa163476bbcf381ee2b5e0c69
Content-Type text/plain
3. Adjuntar en el CUERPO o BODY el archivo TXT
4. Recibirás una respuesta inmediatamente.
HERRAMIENTAS PARA LA RUTA Y EL TOKEN:

Para hacer PRUEBAS de RECOMENDAMOS usar:
● INSOMNIA: Un probador de API gratuito https://insomnia.rest/
FORMA DE TRABAJO
1. Conseguir una RUTA y un TOKEN para trabajar con NUBEFACT (Regístrate o ingresa a tu cuenta en www.nubefact.com).
2. Generar un archivo en formato .TXT con una estructura que se detalla en este documento.
3. Enviar el archivo generado a nuestra WEB SERVICE ONLINE u OFFLINE según corresponda usando la RUTA y el TOKEN.
4. Nosotros a partir de ese archivo generamos el archivo XML y PDF (Según especificaciones de la SUNAT).
5. Te devolveremos inmediatamente como respuesta los datos para que imprimas el documento para tu cliente o si lo deseas te enviaremos el
PDF y XML generado. La impresión del documento seguirá haciéndose desde tu sistema. Enviaremos el documento por email a tu cliente si
así lo indicas en el archivo TXT. Para ver el documento generado ingresa a www.nubefact.com/login con tus datos de acceso, y luego a la
opción "Ver Facturas, Boletas y Notas".
6. Enviaremos el XML generado a la SUNAT y lo almacenaremos junto con el PDF, XML y CDR en la NUBE para que tu cliente pueda
consultarlo en cualquier momento, si así lo desea.
CONSTRUIR UN ARCHIVO TXT

El archivo debe ser construido de tal forma que:
● Sea construido en codificación UTF-8.
● No tenga caracteres especiales escondidos en una codificación distinta a UTF-8 o espacios innecesarios.
● Que no tenga palotes (“|”) en los valores, como en la descripción, denominación, dirección, ETC, ejemplo: “servicio | descripcion” (esto
interrumpe la estructura del TXT).
● La suma de cada línea del comprobante debe coincidir con los totales.
TIPOS DE DATOS
TIPO DESCRIPCIÓN
Integer Número entero
String Texto de 0 hasta 250 caracteres
Text Texto de 0 hasta 1000 caracteres
Numeric Número con decimales, con separador de punto para los decimales y sin separador de comas (,) de miles. Ejemplo: 2034.56
Date Fecha formato DIA-MES-AÑO / DD-MM-YYYY (Separador con guiones medios). Ejemplo: 21-05-2017
false = FALSO (En minúsculas)
Boolean
true = VERDADERO (En minúsculas)
Se pueden hacer 4 tipos de operaciones con nuestra API:

● OPERACIÓN 1: GENERAR FACTURAS, BOLETAS Y NOTAS
● OPERACIÓN 2: CONSULTA DE FACTURAS, BOLETAS Y NOTAS
● OPERACIÓN 3: GENERAR ANULACIÓN DE FACTURAS, BOLETAS Y NOTAS
● OPERACIÓN 4: CONSULTA ANULACIÓN DE FACTURAS, BOLETAS Y NOTAS
A continuación puedes ver un ejemplo junto con la explicación de las estructuras.
OPERACIÓN 1: GENERAR FACTURAS, BOLETAS Y NOTAS CON TXT

La explicación de la estructura y las validaciones de esta operación para ENVIAR y de RESPUESTA se detallan al final de este manual:
IMPORTANTE: Cuidado con los saltos de línea.
TXT PARA ENVIAR A NUBEFACT TXT DE RESPUESTA DE NUBEFACT
operacion|generar_comprobante| tipo_de_comprobante|1|
tipo_de_comprobante|1| serie|FFF1|
serie|FFF1| numero|1|
numero|1| enlace|https://www.nubefact.com/cpe/d4ca3af3-e36e-463d-ac0a-9c
sunat_transaction|1| f6-f70429d2a59a|
cliente_tipo_de_documento|6| aceptada_por_sunat|true|
cliente_numero_de_documento|20600695771| sunat_description|La Factura numero FFF1-1, ha sido aceptada|
cliente_denominacion|NUBEFACTSA| sunat_note||
cliente_direccion|CALLE LIBERTAD 116 MIRAFLORES - sunat_responsecode|0|
LIMA - PERU| sunat_soap_error||
cliente_email|tucliente@gmail.com| pdf_zip_base64||
cliente_email_1|| xml_zip_base64||
cliente_email_2|| cdr_zip_base64||
fecha_de_emision|09-05-2017| cadena_para_codigo_qr|20600695771 | 01 | FFF1 | 000001 |
fecha_de_vencimiento|| 108.00....|
moneda|1| codigo_hash|erUeLXurWJ1QAnN+L0P9G0vnaUQ=|
tipo_de_cambio||
porcentaje_de_igv|18|
descuento_global||
total_descuento||
total_anticipo||
total_gravada|600|
total_inafecta||
total_exonerada||
total_igv|108|
total_impuestos_bolsas||
total_gratuita||
total_otros_cargos||
total|708|
percepcion_tipo||
percepcion_base_imponible||
total_percepcion||
total_incluido_percepcion||
detraccion|false|
observaciones||
documento_que_se_modifica_tipo||
documento_que_se_modifica_serie||
documento_que_se_modifica_numero||
tipo_de_nota_de_credito||
tipo_de_nota_de_debito||
enviar_automaticamente_a_la_sunat|true|
enviar_automaticamente_al_cliente|false|
condiciones_de_pago||
medio_de_pago||
placa_vehiculo||
orden_compra_servicio||
formato_de_pdf||
generado_por_contingencia||
item|NIU|001|DETALLE DEL
PRODUCTO|1|500|590||500|1|90|590|false|||10000000|
item|ZZ|001|DETALLE DEL
SERVICIO|5|20|23.60||100|1|18|118|false|||10000000|
OPERACIÓN 2: CONSULTAR FACTURAS, BOLETAS Y NOTAS CON TXT

operacion|consultar_comprobante| tipo_de_comprobante|1|
tipo_de_comprobante|1| serie|FFF1|
serie|FFF1| numero|1|
numero|1| enlace|https://www.nubefact.com/cpe/d4ca3af3-e36e-463d-ac0a-9cf6-f70429d2a59a|
aceptada_por_sunat|true|
sunat_description|La Factura numero FFF1-1, ha sido aceptada|
sunat_note||
sunat_responsecode|0|
sunat_soap_error||
pdf_zip_base64||
xml_zip_base64||
cdr_zip_base64||
cadena_para_codigo_qr|20600695771 | 01 | FFF1 | 000001 | 108.00....|
codigo_hash|erUeLXurWJ1QAnN+L0P9G0vnaUQ=|
OPERACIÓN 3: ANULAR FACTURAS, BOLETAS Y NOTAS CON TXT

operacion|generar_anulacion| numero|1|
tipo_de_comprobante|1| enlace|https://www.nubefact.com/anulacion/f5f2a22a-4a12-f5
serie|FFF1| e4f07f-0034-415d-8f8e-b27be30cc2f6|
numero|1| sunat_ticket_numero|1494358921555|
motivo|ERROR DEL SISTEMA| aceptada_por_sunat|false|
codigo_unico|| sunat_description||
sunat_note||
sunat_responsecode||
sunat_soap_error||
pdf_zip_base64||
xml_zip_base64||
cdr_zip_base64||
OPERACIÓN 4: CONSULTAR ANULACIÓN DE FACTURAS, BOLETAS Y NOTAS CON TXT

operacion|consultar_anulacion| numero|1|
tipo_de_comprobante|1| enlace|https://www.nubefact.com/anulacion/f5f2a22a-4a12-f5
serie|FFF1| e4f07f-0034-415d-8f8e-b27be30cc2f6|
numero|1| sunat_ticket_numero|1494358921555|
aceptada_por_sunat|false|
sunat_description||
sunat_note||
sunat_responsecode||
sunat_soap_error||
pdf_zip_base64||
xml_zip_base64||
cdr_zip_base64||
EJEMPLOS DE ARCHIVOS TXT

Tenemos archivos TXT DE ejemplo para la mayoría de casos:
1. EJEMPLO GENERAR OPERACIONES GRAVADAS
2. EJEMPLO GENERAR OPERACIONES EXONERADAS
3. EJEMPLO GENERAR OPERACIONES INAFECTAS
4. EJEMPLO GENERAR OPERACIONES GRATUITAS
5. EJEMPLO GENERAR OPERACIONES COMBINADAS GRAVADAS CON GRATUITAS
6. EJEMPLO GENERAR OPERACIONES DE EXPORTACIÓN NO DOMICILIADO
7. EJEMPLO GENERAR OPERACIONES DESCUENTO GLOBAL
8. EJEMPLO GENERAR OPERACIONES DESCUENTO POR ÍTEM
9. EJEMPLO GENERAR OPERACIONES DESCUENTO GLOBAL Y POR ÍTEM
10. EJEMPLO GENERAR OPERACIONES GRAVADA CON OTROS CARGOS
11. EJEMPLO GENERAR OPERACIONES CON PERCEPCIÓN
12. EJEMPLO GENERAR OPERACIONES EN DÓLARES
13. EJEMPLO GENERAR OPERACIONES CON GUIA DE REMISION ADJUNTA
14. EJEMPLO GENERAR OPERACIONES CON PRIMER ANTICIPO
15. EJEMPLO GENERAR OPERACIONES CON ANTICIPO REGULARIZACIÓN
16. EJEMPLO GENERAR OPERACIONES POR CONTINGENCIA
17. MUCHO MÁS.
Los ejemplos son tanto para FACTURAS como para BOLETAS DE VENTA, también hay ejemplos de NOTAS DE CRÉDITO y DÉBITO. Puedes
descargar estos archivos TXT de ejemplo en el siguiente link: https://www.nubefact.com/downloads/EJEMPLOS-DE-ARCHIVOS-TXT
EJEMPLOS DE CÓDIGO EN LENGUAJES DE PROGRAMACIÓN

Actualmente tenemos códigos de ejemplo para los siguiente lenguajes de programación, no importa que lenguaje uses, podemos ayudarte,
contáctanos.
PHP
Descarga el código en: https://www.nubefact.com/downloads/PHP-INTEGRACION-CON-NUBEFACT-EJEMPLO-CODIGO-TXT
C#
Descarga el código en: https://www.nubefact.com/downloads/CSHARP-INTEGRACION-CON-NUBEFACT-EJEMPLO-CODIGO-TXT
JAVA
Descarga el código en: https://www.nubefact.com/downloads/JAVA-INTEGRACION-CON-NUBEFACT-EJEMPLO-CODIGO-TXT
VB.NET
Descarga el código en: https://www.nubefact.com/downloads/VBNET-INTEGRACION-CON-NUBEFACT-EJEMPLO-CODIGO-TXT
VISUAL BASIC 6
Descarga el código en: https://www.nubefact.com/downloads/VB6-INTEGRACION-CON-NUBEFACT-EJEMPLO-CODIGO-TXT
VISUAL FOX PRO

Descarga el código en: https://www.nubefact.com/downloads/VFPRO-INTEGRACION-CON-NUBEFACT-EJEMPLO-CODIGO-TXT
No dudes en contactarnos de existir alguna pregunta o inquietud.
REPRESENTACIÓN IMPRESA
Nosotros generamos 3 tipos de formatos o tamaños de PDF o REPRESENTACIÓN IMPRESA:
● FORMATO o TAMAÑO A4
● FORMATO o TAMAÑO A5 (MITAD DE A4)
● FORMATO o TAMAÑO TICKET
También podemos personalizar el tamaño y el diseño que deseas.
FORMATO o TAMAÑO A4 FORMATO o TAMAÑO A5 (MITAD DE A4) FORMATO TICKET

REPRESENTACIÓN IMPRESA PROPIA:

Si generas tu propia representación impresa debes hacerlo considerando:
● Incluir la información mínima que imprimimos en los PDF.
● Añadiendo EL CÓDIGO QR (Obligatorio desde el 01/01/2019) el cual contiene.
CÓDIGO QR
Simbología
Para la generación del código de barras se hará uso de la simbología QR Code 2005 de acuerdo a la Norma ISO/IEC 18004:2006. Denominado
“Information technology – Automatic identification and data capture techniques – QR Code 2005 bar code symbology specification”. No debe usarse las
variantes como Micro QR, Etc.
Características técnicas
● Nivel de corrección de error (Error Correction Level): nivel Q.
● Dimensiones mínimas de los elementos del código de barras:
● Ancho mínimo de un módulo (X-Dimension): 0,0075 pulgadas (0,190 mm).
● Codificacion de caracteres UTF8
Información a consignar en el código de barras
A. Número de RUC del emisor electrónico.

B. Tipo de comprobante de pago electrónico.
C. Numeración conformada por serie y número correlativo.
D. Sumatoria IGV, de ser el caso.
E. Importe total de la venta, cesión en uso o servicio prestado.
F. Fecha de emisión.
G. Tipo de documento del adquirente o usuario, de ser el caso.
H. Número de documento del adquirente o usuario, de ser el caso.
La información señalada en los incisos anteriores de este numeral debe consignarse con el mismo formato empleado en el comprobante de pago
electrónico o la nota electrónica y se estructura de acuerdo al siguiente orden, siendo el separador de campo el carácter pipe (“|”):
RUC | TIPO DE DOCUMENTO | SERIE | NUMERO | MTO TOTAL IGV | MTO TOTAL DEL COMPROBANTE | FECHA DE EMISION | TIPO DE
DOCUMENTO ADQUIRENTE | NUMERO DE DOCUMENTO ADQUIRENTE | CODIGO HASH |
Características de la Impresión del código QR
● Posición del código de barras dentro de la representación impresa: Parte inferior de la representación impresa.
● Tamaño máximo: 6 cm de alto y 6 cm de ancho (incluye el espacio en blanco alrededor del código).
● Zona de silencio mínimo (Quiet Zone) o ancho mínimo obligatorio en blanco alrededor del código impreso para delimitarlo: 1 mm.
● Color de impresión: Negro.
PASAR A PRODUCCIÓN
NOTAS MUY IMPORTANTES
● Emitir de forma CORRELATIVA, empezando con el número 1, para cada tipo de documento.
● El número correlativo es entre NOTAS DE CRÉDITO para FACTURAS y para BOLETAS, ya que empiezan con F o con B.
Antes de pasar el sistema a producción, solicitaremos que se generen desde su sistema algunos de los siguientes documentos vía API (Según
corresponda):
● 1 Factura Electrónica en Soles
● 1 Factura Electrónica en Dólares
● 1 Factura Electrónica para operaciones Exoneradas o Inafectas
● 1 Factura Electrónica para Exportación

● 1 Nota de Crédito Electrónica modificando o anulando una Factura Electrónica
● 1 Nota de Débito Electrónica modificando o modificando una Factura Electrónica
● 1 Factura Electrónica combinada con operaciones Gravadas, Inafectas o Exoneradas
● 1 Consulta de Estado en la Sunat de la Factura Electrónica
● 1 Boleta de Venta Electrónica en Soles
● 1 Boleta de Venta Electrónica en Dólares
● 1 Boleta de Venta Electrónica para operaciones Exoneradas o Inafectas
● 1 Boleta de Venta Electrónica para Exportación
● 1 Boleta de Venta Electrónica combinada con operaciones Gravadas, Inafectas o Exoneradas
● 1 Nota de Crédito Electrónica modificando o anulando una Boleta de Venta Electrónica
● 1 Nota de Débito Electrónica modificando o modificando una Boleta de Venta Electrónica
● 1 Consulta de Estado en la Sunat de la Boleta de Venta Electrónica
● 1 Comunicación de Baja de Factura Electrónica
● 1 Comunicación de Baja de Boleta de Venta Electrónica
● 1 Consulta de Estado de Comunicación de Baja
ESTRUCTURA DE ARCHIVOS TXT

ESTRUCTURA PARA GENERAR FACTURAS, BOLETAS Y NOTAS
CABECERA DEL DOCUMENTO
LA CABECERA sólo debe contener dos campos por fila, separado con PALOTES “|”
CAMPO 1 CAMPO 2
Cada FILA debe empezar
textualmente con esta TIPO DE REQUISIT
VALOR EJEMPLO LONGITUD
palabra. DATO O
Siempre deberá ser "generar_comprobante" para enviar
generar_comprob
operacion FACTURAS, BOLETAS, NOTAS DE CRÉDITO o String Obligatorio 12 exactos
ante
DÉBITO
Tipo de COMPROBANTE que desea generar:
1 = FACTURA
tipo_de_comprobante 2 = BOLETA 1 Integer Obligatorio 1 exacto
3 = NOTA DE CRÉDITO
4 = NOTA DE DÉBITO
Empieza con "F" para FACTURAS y NOTAS
ASOCIADAS. Empieza con "B" para BOLETAS DE
VENTA y NOTAS ASOCIADAS.
serie Si está comunicando un comprobante emitido en FFF1 String Obligatorio 4 exactos
contingencia, la serie debe empezar NO debe empezar
con "F" ni con "B". Debería empezar con "0", ejemplo:
"0001"
Número correlativo del documento, sin ceros a la
numero 32 Integer Obligatorio 1 hasta 8
izquierda
La mayoría de veces se usa el 1, las demás son para
tipos de operaciones muy especiales, no dudes en
consultar con nosotros para más información.
1 = VENTA INTERNA
2 = EXPORTACIÓN
4 = VENTA INTERNA – ANTICIPOS
29 = VENTAS NO DOMICILIADOS QUE NO
sunat_transaction 1 Integer Obligatorio 1 hasta 2
CALIFICAN COMO EXPORTACIÓN.
30 = OPERACIÓN SUJETA A DETRACCIÓN.
33 = DETRACCIÓN - SERVICIOS DE TRANSPORTE
CARGA
34 = OPERACIÓN SUJETA A PERCEPCIÓN
6 = RUC - REGISTRO ÚNICO DE CONTRIBUYENTE

1 = DNI - DOC. NACIONAL DE IDENTIDAD
- = VARIOS - VENTAS MENORES A S/.700.00 Y
cliente_tipo_de_documento OTROS 6 Integer Obligatorio 1 exacto
4 = CARNET DE EXTRANJERÍA
7 = PASAPORTE
A = CÉDULA DIPLOMÁTICA DE IDENTIDAD
0 = NO DOMICILIADO, SIN RUC (EXPORTACIÓN)

cliente_numero_de_documen
Ejemplo: RUC del CLIENTE, número de DNI, etc. 20100036011 String Obligatorio 1 hasta 15
to
cliente_denominacion Razón o nombre completo del CLIENTE. Tu Cliente SA String Obligatorio 1 hasta 100
Dirección completa (OPCIONAL en caso de ser una

cliente_direccion Av Alborada 999 String Obligatorio 1 hasta100
BOLETA DE VENTA o NOTA ASOCIADA)
compras@tuclient
cliente_email Dirección de email debe ser válido. String Opcional 1 hasta 250
esa.com
cliente_email_1 Dirección de email debe ser válido. String Opcional 1 hasta 250
cliente_email_2 Dirección de email debe ser válido. String Opcional 1 hasta 250
Debe ser la fecha actual.
fecha_de_emision Formato DD-MM-AAAA 09-08-2018 Date Obligatorio 10 exactos
Ejemplo: 10-05-2017
fecha_de_vencimiento Deber ser fecha posterior a la fecha de emisión. 09-08-2018 Date Opcional 10 exactos
De necesitar más monedas no dudes en contactarte
con nosotros.
moneda 1 = SOLES 1 Integer Obligatorio 1 exacto
2 = DÓLARES
3 = EUROS
1 entero
tipo_de_cambio 3.421 Numeric Condicional con 3
decimales
1 hasta 2
porcentaje_de_igv 18.00 Numeric Obligatorio enteros con
2 decimales
1 hasta 12
descuento_global Numeric Condicional enteros con
2 decimales
1 hasta 12
total_descuento Numeric Condicional enteros con
2 decimales
1 hasta 12
total_anticipo Numeric Condicional enteros con
2 decimales
1 hasta 12
total_gravada 500.00 Numeric Condicional enteros con
2 decimales
1 hasta 12
total_inafecta Numeric Condicional enteros con
2 decimales
1 hasta 12
total_exonerada Numeric Condicional enteros con
2 decimales
1 hasta 12
total_igv 90.00 Numeric Condicional enteros con
2 decimales
1 hasta 12
total_impuestos_bolsas 0.1 Numeric Condicional enteros con
2 decimales
1 hasta 12
total_gratuita Numeric Condicional enteros con
2 decimales
1 hasta 12
total_otros_cargos Numeric Condicional enteros con
2 decimales
1 hasta 12
total 590.00 Numeric Obligatorio enteros con
2 decimales
1 = PERCEPCIÓN VENTA INTERNA - TASA 2%

2 = PERCEPCIÓN A LA ADQUISICIÓN DE
percepcion_tipo COMBUSTIBLE - TASA 1% Integer Condicional 1 exacto
3 = PERCEPCIÓN REALIZADA AL AGENTE DE
PERCEPCIÓN CON TASA ESPECIAL-TASA 0.5%
1 hasta 12
percepcion_base_imponible Numeric Condicional enteros con
2 decimales
1 hasta 12
total_percepcion Numeric Condicional enteros con
2 decimales
1 hasta 12
total_incluido_percepcion Numeric Condicional enteros con
2 decimales

detraccion false Boolean Condicional Hasta 5
Texto de 0 hasta 1000 caracteres. Si se desea saltos de XXXXX <br>

observaciones Text Opcional Hasta 5
línea para la representación impresa o PDF usar <br>. YYYYYY
documento_que_se_modifica 1 = FACTURAS ELECTRÓNICAS

Integer Condicional 1 exacto
_tipo 2 = BOLETAS DE VENTA ELECTRÓNICAS
documento_que_se_modifica SERIE de la FACTURA o BOLETA que se modifica

String Condicional 4 exactos
_serie (previamente comunicado)
documento_que_se_modifica NÚMERO de la FACTURA o BOLETA que se modifica
Integer Condicional 1 hasta 8
_numero (previamente comunicado)
1 = ANULACIÓN DE LA OPERACIÓN
2 = ANULACIÓN POR ERROR EN EL RUC
3 = CORRECCIÓN POR ERROR EN LA
DESCRIPCIÓN
4 = DESCUENTO GLOBAL
5 = DESCUENTO POR ÍTEM
6 = DEVOLUCIÓN TOTAL 1a2
tipo_de_nota_de_credito Integer Condicional
7 = DEVOLUCIÓN POR ÍTEM exacto
8 = BONIFICACIÓN
9 = DISMINUCIÓN EN EL VALOR
10= OTROS CONCEPTOS
11= AJUSTES AFECTOS AL IVAP
12 = AJUSTES DE OPERACIONES DE
EXPORTACIÓN
1 = INTERESES POR MORA
2 = AUMENTO DE VALOR
tipo_de_nota_de_debito 3 = PENALIDADES Integer Condicional 1 exacto
4= AJUSTES AFECTOS AL IVAP
5 = AJUSTES DE OPERACIONES DE EXPORTACIÓN
enviar_automaticamente_a_l false = FALSO (En minúsculas)
true Boolean Condicional Hasta 5
a_sunat true = VERDADERO (En minúsculas)
enviar_automaticamente_al_ false = FALSE (En minúsculas)
true Boolean Condicional Hasta 5
cliente true = VERDADERO (En minúsculas)
CRÉDITO 15
condiciones_de_pago String Opcional 1 hasta 250
DÍAS
TARJETA VISA
medio_de_pago String Opcional 1 hasta 250
OP: 232231
placa_vehiculo ALF-321 String Opcional 1 hasta 8
orden_compra_servicio 21344 String Opcional 1 hasta 20
1 = 001 Azúcar y melaza de caña

2 = 002 Arroz
3 = 003 Alcohol etílico
5 = 005 Maíz amarillo duro
detraccion_tipo integer Condicional Hasta 2
7 = 007 Caña de azúcar
8 = 008 Madera
9 = 009 Arena y piedra.
10 = 010 Residuos, subproductos, desechos, recortes y
desperdicios
11 = 011 Bienes gravados con el IGV, o renuncia a la

exoneración
12 = 012 Intermediación laboral y tercerización
13 = 014 Carnes y despojos comestibles
14 = 016 Aceite de pescado
15 = 017 Harina, polvo y “pellets” de pescado,
crustáceos, moluscos y demás invertebrados acuáticos
17 = 019 Arrendamiento de bienes muebles
18 = 020 Mantenimiento y reparación de bienes
muebles
19 = 021 Movimiento de carga
20 = 022 Otros servicios empresariales
21 = 023 Leche
22 = 024 Comisión mercantil
23 = 025 Fabricación de bienes por encargo
24 = 026 Servicio de transporte de personas
25 = 027 Servicio de transporte de carga
28 = 030 Contratos de construcción
29 = 031 Oro gravado con el IGV
30 = 032 Paprika y otros frutos de los generos
capsicum o pimienta
32 = 034 Minerales metálicos no auríferos
33 = 035 Bienes exonerados del IGV
34 = 036 Oro y demás minerales metálicos exonerados
del IGV
35 = 037 Demás servicios gravados con el IGV
37 = 039 Minerales no metálicos
38 = 040 Bien inmueble gravado con IGV
39 = 041 Plomo
40 = 013 ANIMALES VIVOS
41 = 015 ABONOS, CUEROS Y PIELES DE ORIGEN
ANIMAL
42 = 099 LEY 30737
1 hasta
12 enteros,
detraccion_total Total de la Detracción Numeric Condicional hasta con
10
decimales
1 = 001 - Depósito en cuenta
2 = 002 - Giro
3 = 003 - Transferencia de fondos
4 = 004 - Orden de pago
5 = 005 - Tarjeta de débito
6 = 006 - Tarjeta de crédito emitida en el país por una
empresa del sistema financiero
7 = 007 - Cheques con la cláusula de NO
NEGOCIABLE, INTRANSFERIBLES, NO A LA ORDEN
u otra equivalente, a que se refiere el inciso g) del
artículo 5 de la ley
8 = 008 - Efectivo, por operaciones en las que no existe
obligación de utilizar medio de pago
9 = 009 - Efectivo, en los demás casos
medio_de_pago_detraccion 10 = 010 - Medios de pago usados en comercio exterior
11 = 011 - Documentos emitidos por las EDPYMES y
(Nota: Recuerde tener las cooperativas de ahorro y crédito no autorizadas a
Registrado el número de captar depósitos del público Integer Condicional 1 hasta 2
cuenta para detracciones 12 = 012 - Tarjeta de crédito emitida en el país o en el
en la opción de “cuentas exterior por una empresa no perteneciente al sistema
bancarias” en su panel) financiero, cuyo objeto principal sea la emisión y
administración de tarjetas de crédito
13 = 013 - Tarjetas de crédito emitidas en el exterior por
empresas bancarias o financieras no domiciliadas
14 = 101 - Transferencias – Comercio exterior
15 = 102 - Cheques bancarios - Comercio exterior
16 = 103 - Orden de pago simple - Comercio exterior
17 = 104 - Orden de pago documentario - Comercio
exterior
18 = 105 - Remesa simple - Comercio exterior
19 = 106 - Remesa documentaria - Comercio exterior
20 = 107 - Carta de crédito simple - Comercio exterior
21 = 108 - Carta de crédito documentario - Comercio
exterior
22 = 999 - Otros medios de pago
Código de Ubigeo de Origen:

ubigeo_origen http://www.sunat.gob.pe/legislacion/superin/2018/anexo Integer Condicional 6 exactos
I-254-2018.pdf
Dirección completa del origen (SOLO EN TIPO
direccion_origen String Condicional 1 hasta 100
DETRACCIÓN DE TRANSPORTE DE CARGA)
Código de Ubigeo de Destino :
ubigeo_destino http://www.sunat.gob.pe/legislacion/superin/2018/anexo Integer Condicional 6 exactos
I-254-2018.pdf
Dirección completa del destino(SOLO EN TIPO
direccion_destino String Condicional 1 hasta 100
DETRACCIÓN DE TRANSPORTE DE CARGA)
detalle_viaje Detalle del transporte. String Condicional 1 hasta 100
1 hasta
Valor Referencia del servicio de Transporte(SOLO EN 12 enteros,
val_ref_serv_trans Numeric Condicional
TIPO DETRACCIÓN DE TRANSPORTE DE CARGA) hasta con
2 decimales
1 hasta
Valor Referencial Carga Efectiva (SOLO EN TIPO 12 enteros,
val_ref_carga_efec Numeric Condicional
DETRACCIÓN DE TRANSPORTE DE CARGA) hasta con
2 decimales
1 hasta
Valor Referencial Carga Útil(SOLO EN TIPO 12 enteros,
val_ref_carga_util Numeric Condicional
DETRACCIÓN DE TRANSPORTE DE CARGA) hasta con
2 decimales
Recuerde que por el momentos estos datos son
opcionales para las operaciones de detracción 1004 -
DETALLES DEL TRAMO y
Transporte de carga, de usarse 1 debe completar todas,
VEHÍCULO
para que se creen las etiquetas debidamente en el
XML.
Punto de origen del viaje.(SOLO EN TIPO
DETRACCIÓN DE TRANSPORTE DE CARGA -
Opcional)
punto_origen_viaje Integer Condicional 6 exactos
http://www.sunat.gob.pe/legislacion/superin/2018/anexo
I-254-2018.pdf
Punto de destino del viaje.(SOLO EN TIPO

DETRACCIÓN DE TRANSPORTE DE CARGA -
Opcional)
punto_destino_viaje Integer Condicional 6 exactos
http://www.sunat.gob.pe/legislacion/superin/2018/anexo
I-254-2018.pdf
Descripción del tramo.(SOLO EN TIPO DETRACCIÓN

descripcion_tramo String Condicional 1 hasta 100
DE TRANSPORTE DE CARGA - Opcional)
Valor preliminar referencial sobre la carga efectiva (Por 1 hasta
val_ref_carga_efec_tramo_vir el tramo virtual recorrido).(SOLO EN TIPO 12 enteros,
Numeric Condicional
tual DETRACCIÓN DE TRANSPORTE DE CARGA - hasta con
Opcional) 2 decimales
Configuración vehicular del vehículo.(SOLO EN TIPO
hasta 15
configuracion_vehicular DETRACCIÓN DE TRANSPORTE DE CARGA - String Condicional
caracteres
Opcional)
1 hasta
Carga útil en toneladas métricas del vehículo.(SOLO
12 enteros,
carga_util_tonel_metricas EN TIPO DETRACCIÓN DE TRANSPORTE DE Numeric Condicional
hasta con
CARGA - Opcional)
2 decimales
1 hasta
Carga efectiva en toneladas métricas del
12 enteros,
carga_efec_tonel_metricas vehículo.(SOLO EN TIPO DETRACCIÓN DE Numeric Condicional
hasta con
TRANSPORTE DE CARGA - Opcional)
2 decimales
Valor referencial por tonelada métrica.(SOLO EN TIPO
val_ref_tonel_metrica DETRACCIÓN DE TRANSPORTE DE CARGA - Numeric Condicional 1 hasta 5
Opcional)
Valor preliminar referencial por carga útil nominal 1 hasta
val_pre_ref_carga_util_nomin (Tratándose de más de 1 vehículo).(SOLO EN TIPO 12 enteros,
Numeric Condicional
al DETRACCIÓN DE TRANSPORTE DE CARGA - hasta con
Opcional) 2 decimales
Indicador de aplicación de factor de retorno al

indicador_aplicacion_retorno
vacío.(SOLO EN TIPO DETRACCIÓN DE Boolean Condicional Hasta 5
_vacio
TRANSPORTE DE CARGA - Opcional)
Matrícula de la embarcación pesquera.(SOLO EN TIPO
matricula_emb_pesquera String Condicional Hasta 15
DETRACCIÓN DE RECURSOS HIDROBIOLÓGICOS )
Nombre de la embarcación pesquera.(SOLO EN TIPO
nombre_emb_pesquera String Condicional Hasta 50
Descripción del tipo de la especie vendida.(SOLO EN
descripcion_tipo_especie_ve
TIPO DETRACCIÓN DE RECURSOS String Condicional Hasta 100
ndida
HIDROBIOLÓGICOS )
Lugar de descarga.(SOLO EN TIPO DETRACCIÓN DE
lugar_de_descarga String Condicional Hasta 200
RECURSOS HIDROBIOLÓGICOS )
12 enteros,
Cantidad de la especie vendida.(SOLO EN TIPO
cantidad_especie_vendida Numeric Condicional hasta con
2 decimales
Fecha de descarga.(SOLO EN TIPO DETRACCIÓN DE
RECURSOS HIDROBIOLÓGICOS )
fecha_de_descarga Date Condicional 10 exactos
Formato AAAA-MM-DD
Ejemplo: 2020-05-22
Formato de PDF que se desea generar para la

representación, si se deja en blanco se genera el
formato_de_pdf String Opcional 2 hasta 5
formato definido por defecto en NUBEFACT. Se puede
elegir entre A4, A5 o TICKET.
Si está comunicando un comprobante emitido en
generado_por_contingencia Boolean Opcional Hasta 5
contingencia debería ser “true” (en minúsculas).
Para los ítems o líneas del documento:
ITEMS O LINEAS DEL DOCUMENTO

En los ITEMS o LINEAS deben existir UNA O VARIAS FILAS.
TIPO DE
CAMPO VALOR EJEMPLO REQUISITO LONGITUD
DATO
Cada FILA debe empezar con la palabra
CAMPO 1 item String Obligatorio 4 exactos
"item" (en SINGULAR)
Unidad de medida:
NIU = PRODUCTO
ZZ = SERVICIO
CAMPO 2 NIU String Obligatorio 2 hasta 5
Si necesita mas unidades de medida debe
crearlas primeramente en su cuenta de
NUBEFACT para que estén disponible.
CAMPO 3 Código interno del producto o servicio. C001 String Opcional 1 hasta 250
SERVICIO DE REPARACIÓN DE
CAMPO 4 Descripción del producto o servicio. Text Obligatorio 1 hasta 250
PC, ETC.
1 hasta 12
enteros, hasta
CAMPO 5 Cantidad. 1 Numeric Obligatorio
con 10
decimales
1 hasta 12
enteros, hasta
CAMPO 6 Valor unitario. 500.00 Numeric Obligatorio
con 10
decimales
1 hasta 12
enteros, hasta
CAMPO 7 Precio unitario. 590.00 Numeric Obligatorio
con 10
decimales
1 hasta 12
Descuento de la línea, el descuento ANTES enteros, hasta
CAMPO 8 Numeric Opcional
de los impuestos. con 2
decimales
1 hasta 12
Subtotal: Resultado de VALOR UNITARIO enteros, hasta
CAMPO 9 500.00 Numeric Obligatorio
por la CANTIDAD menos el DESCUENTO. con 2
decimales
Tipo de IGV:
1 = Gravado - Operación Onerosa
2 = Gravado – Retiro por premio
3 = Gravado – Retiro por donación
4 = Gravado – Retiro
5 = Gravado – Retiro por publicidad
6 = Gravado – Bonificaciones
7 = Gravado – Retiro por entrega a
trabajadores. 1 hasta 2
CAMPO 10 1 Integer Obligatorio
8 = Exonerado - Operación Onerosa enteros
9 = Inafecto - Operación Onerosa
10 = Inafecto – Retiro por Bonificación.
11 = Inafecto – Retiro
12 = Inafecto – Retiro por Muestras Médicas.
13 = Inafecto - Retiro por Convenio Colectivo.
14 = Inafecto – Retiro por premio.
15 = Inafecto - Retiro por publicidad
16 = Exportación.
1 hasta
12 enteros,
CAMPO 11 Total del IGV de la línea 90.00 Numeric Obligatorio
hasta con
10 decimales
1 hasta 12
enteros, hasta
CAMPO 12 Total de la línea 590.00 Numeric Obligatorio
con 2
decimales
Para indicar que desea regularizar un
anticipo.
CAMPO 13 false Boolean Obligatorio Hasta 5
CAMPO 14 Serie del documento que contiene el anticipo. String Condicional 4 exactos
Número del documento que contiene el

CAMPO 15 Integer Condicional 1 hasta 8
anticipo.
Código de Producto Sunat obligatorio desde
01/01/2019. Visita este Excel para elegir el
CAMPO 16 código correspondiente: 10000000 String Obligatorio Hasta 8
https://drive.google.com/open?id=10UKf7u_st
ss_48azHg4MrBizSWvPGFBo0lPlPSeDS0w
1 hasta 12
enteros, hasta
CAMPO 17 Otros cargos por item Numeric Condicional
con 2
decimales
CAMPO 18 Tipo de ISC (1, 2 o 3) Integer Condicional 1 dígito
1 hasta 12
enteros, hasta
CAMPO 19 ISC por línea Numeric Condicional
con 2
decimales
1 hasta 12
enteros, hasta
CAMPO 20 impuesto de bolsas plásticas (ICBPER) 0.1 Numeric Condicional
con dos
decimales
Opcional
(Recuerde que
Tipo de IVAP: si va a usar
este nodo o
CAMPO 21 17 = IVAP Gravado - String etiqueta no -
101 = IVAP Gratuito tiene que usar
el nodo o
etiqueta
tipo_de_igv)
Para agregar GUÍAS considerar lo siguiente:
GUÍA DE REMISIÓN
En las GUÍAS pueden existir UNA O VARIAS FILAS.
TIPO DE
CAMPO VALOR EJEMPLO REQUISITO LONGITUD
DATO
Cada FILA debe empezar con la palabra

"guia" (en SINGULAR) ubicado en el CAMPO
CAMPO 1 guia String Obligatorio 4 exactos
1 seguido de los DATOS de las siguientes
CAMPOS.
Tipo de la GUÍA DE REMISIÓN
RELACIONADA:
CAMPO 2 1 Integer Opcional 1 exacto
1 = GUÍA DE REMISIÓN REMITENTE
2 = GUÍA DE REMISIÓN TRANSPORTISTA
Serie y número de la GUÍA DE REMISIÓN
CAMPO 3 RELACIONADA separado con un guión 0322-1 String Opcional 1 hasta 30
medio.
ESTRUCTURA PARA CONSULTAR FACTURAS, BOLETAS Y NOTAS

TXT PARA CONSULTAR FACTURAS, BOLETAS Y NOTAS
CAMPO 1 CAMPO 2
Cada FILA debe
empezar textualmente VALOR EJEMPLO TIPO DE DATO REQUISITO LONGITUD
con esta palabra.
Este valor siempre deberá ser
"consultar_comprobante" para consultar consultar_compro
operacion String Obligatorio 13 exactos
FACTURAS, BOLETAS, NOTAS DE CRÉDITO o bante
DÉBITO
Tipo de COMPROBANTE que desea generar
1 = FACTURA
4 = NOTA DE DÉBITO
serie ASOCIADAS. Empieza con "B" para BOLETAS DE B001 String Obligatorio 4 exactos
VENTA y NOTAS ASOCIADAS
Número correlativo del documento, sin ceros a la
izquierda
ESTRUCTURA DE RESPUESTA DE NUBEFACT PARA FACTURAS, BOLETAS, NOTAS

ESTRUCTURA TXT DE RESPUESTA DE NUBEFACT PARA FACTURAS, BOLETAS Y NOTAS
FILA
Las respuestas CAMPO 1
siempre tendrán Cada FILA empieza con esta CAMPO 2
el mismo orden palabra.
en las FILAS
Tipo de COMPROBANTE que generó:
1 = FACTURA
FILA 1 tipo_de_comprobante 2 = BOLETA
4 = NOTA DE DÉBITO
FILA 2 serie Serie de documento generado
FILA 3 numero Número del documento generado
ENLACE único asignado por NUBEFACT.
FILA 4 enlace Para ver el PDF puedes agregar la extensión .pdf, ejemplo:
https://www.nubefact.com/cpe/xxxxxxxx.pdf
FILA 5 aceptada_por_sunat
FILA 6 sunat_description Cuando hay errores en la SUNAT se describirá el error.
FILA 7 sunat_note Cuando hay errores en la SUNAT se describirá el error.
FILA 8 sunat_responsecode Cuando hay errores en la SUNAT se describirá el error.
FILA 9 sunat_soap_error Otros errores que imposibilitan el envío a la SUNAT.

Contenido del archivo xml zipeado en base64 que puedes almacenar de ser necesario.
FILA 10 pdf_zip_base64
(Se debe activar esta opción desde “Configuración principal” en NUBEFACT).
Contenido del archivo pdf zipeado en base64 que puedes almacenar de ser necesario.
FILA 11 xml_zip_base64
(Se debe activar esta opción desde “Configuración principal” en NUBEFACT).
Contenido del archivo cdr de sunat zipeado en base64 que puedes almacenar de ser
FILA 12 cdr_zip_base64
necesario. (Se debe activar esta opción desde “Configuración principal” en NUBEFACT)
Puedes generar el código QR con esta cadena, puedes usarla para construir tu propia
FILA 13 cadena_para_codigo_qr
representación impresa.
FILA 14 codigo_hash Código HASH para que puedes usarla para construir tu propia representación impresa.
Enlace que contiene del archivo PDF que puedes almacenar de ser necesario, mandarlo
FILA 15 enlace_del_pdf
a la impresora o mostrarlo en un navegador.
Enlace que contiene del archivo XML que puedes almacenar de ser necesario, mandarlo
FILA 16 enlace_del_xml
Enlace que contiene del archivo CDR que puedes almacenar de ser necesario, mandarlo
FILA 17 enlace_del_cdr
ESTRUCTURA PARA GENERAR ANULACIÓN O COMUNICACIÓN DE BAJA
ESTRUCTURA Y VALIDACIONES DE ARCHIVOS TXT PARA GENERAR ANULACIONES O COMUNICACIONES DE BAJA
CAMPO 2
CAMPO 1
Cada FILA debe
empezar con esta TIPO DE
palabra. VALOR EJEMPLO REQUISITO LONGITUD
DATO
Este valor siempre deberá ser "generar_anulacion"

operacion para anular FACTURAS, BOLETAS, NOTAS DE generar_anulacion String Obligatorio 17 exactos
CRÉDITO o DÉBITO
Tipo de COMPROBANTE que desea anular

1 = FACTURA
4 = NOTA DE DÉBITO
serie Serie de documento que desea anular FFF1 String Obligatorio 4 exactos
numero Número del documento que desea anular 31 Integer Obligatorio 1 hasta 8
ERROR DE
motivo Motivo de anulación. String Obligatorio Hasta 100
SISTEMA
Usar esto sólo si deseas que controlemos la

generación de documentos. Código único
codigo_unico generado y asignado por tu sistema. Por ejemplo, FFF1-00000031 String Opcional Hasta 250
puede estar compuesto por el tipo de documento,
serie y número correlativo.
ESTRUCTURA PARA CONSULTAR ANULACIÓN O COMUNICACIÓN DE BAJA

TXT PARA CONSULTAR ANULACIONES O COMUNICACIONES DE BAJA
CAMPO 2
CAMPO 1
Cada FILA debe
empezar con esta VALOR EJEMPLO TIPO DE DATO REQUISITO LONGITUD
palabra.
Este valor siempre deberá ser
"consultar_anulacion" para consultar consultar_anulacio
operacion String Obligatorio 19 exactos
FACTURAS, BOLETAS, NOTAS DE CRÉDITO n
o DÉBITO
Tipo de COMPROBANTE que desea consultar

si fue anulado
1 = FACTURA
tipo_de_comprobante 1 Integer Obligatorio 1 exacto
2 = BOLETA
4 = NOTA DE DÉBITO
serie ASOCIADAS. Empieza con "B" para BOLETAS B002 String Obligatorio 4 exactos
DE VENTA y NOTAS ASOCIADAS
Número correlativo del documento, sin ceros a
la izquierda
ESTRUCTURA DE LA RESPUESTA DE NUBEFACT PARA ANULACIÓN O COMUNICACIÓN DE

BAJA
ESTRUCTURAS DE TXT DE RESPUESTA DE NUBEFACT PARA ANULACIONES O COMUNICACIONES DE BAJA
FILA
Las respuestas siempre CAMPO 1
CAMPO 2
tendrán un orden en las Cada FILA empieza con esta palabra.
FILAS
numero Número del documento generado Integer
ENLACE único asignado por NUBEFACT.
enlace Para ver el PDF puedes agregar la extensión .pdf, ejemplo: String
https://www.nubefact.com/cpe/xxxxxxxx.pdf
sunat_ticket_numero Este número es asignado por la SUNAT String
aceptada_por_sunat Boolean
sunat_description Cuando hay errores en la SUNAT se describirá el error String
sunat_note Cuando hay errores en la SUNAT se describirá el error String
sunat_responsecode Cuando hay errores en la SUNAT se describirá el error String
sunat_soap_error Otros errores que imposibilitan el envío a la SUNAT String
Contenido del archivo xml zipeado en base64 que puedes almacenar de ser necesario (Se
xml_zip_base64 Text
debe activar esta opción desde “Configuración principal” en NUBEFACT).
Contenido del archivo pdf zipeado en base64 que puedes almacenar de ser necesario (Se
pdf_zip_base64 Text
debe activar esta opción desde “Configuración principal” en NUBEFACT).
Contenido del archivo cdr de sunat zipeado en base64 que puedes almacenar de ser
cdr_zip_base64 Text
necesario (Se debe activar esta opción desde “Configuración principal” en NUBEFACT).
Enlace que contiene del archivo PDF que puedes almacenar de ser necesario, mandarlo a la
enlace_del_pdf Text
impresora o mostrarlo en un navegador.
Enlace que contiene del archivo XML que puedes almacenar de ser necesario, mandarlo a la
enlace_del_xml Text
Enlace que contiene del archivo CDR que puedes almacenar de ser necesario, mandarlo a la
enlace_del_cdr Text
MANEJO DE ERRORES
MENSAJES DE ERROR
EJEMPLO DE UNA RESPUESTA CON ERROR
errors|El archivo enviado no cumple con el formato establecido|

codigo|20|
CÓDIGO DESCRIPCIÓN
10 No se pudo autenticar, token incorrecto o eliminado
La ruta o URL que estás usando no es correcta o no existe. Ingresa a tu cuenta en www.nubefact.com en la opción Api-Integración para
11 verificar este dato
12 Solicitud incorrecta, la cabecera (Header) no contiene un Content-Type correcto

20 El archivo enviado no cumple con el formato establecido
21 No se pudo completar la operación, se acompaña el problema con un mensaje
22 Documento enviado fuera del plazo permitido
23 Este documento ya existe en NubeFacT
24 El documento indicado no existe o no fue enviado a NubeFacT
40 Error interno desconocido
50 Su cuenta ha sido suspendida
51 Su cuenta ha sido suspendida por falta de pago
CÓDIGOS DE ESTADO HTTP

CÓDIGO DESCRIPCIÓN
200 Operación exitosa
400 Solicitud incorrecta
401 No autorizado
500 error de servidor interno

Nubefact Doc Api TXT V1

Cargado por

Copyright:

Formatos disponibles

Nubefact Doc Api TXT V1

Cargado por

Información del documento

Descripción original:

Título original

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Nubefact Doc Api TXT V1

Cargado por

Copyright:

Formatos disponibles

INTEGRACIÓN FÁCIL CON ARCHIVO TXT

Para consultas escribir a ​[email protected]​ o al WhatsApp 924 353365

FECHA VERSIÓN DE ESTE DOCUMENTO DETALLE

4/05/2017 1.1 Nuevas estructuras, archivo TXT.

Generar para contingencia (Comunicar facturas físicas emitidas como medida de

5/12/2018 1.3 Código de Producto SUNAT.

24/12/2018 1.4 Crear cuenta para DEMO

10/03/2019 1.5 Enlace de PDF, XML Y CDR en las respuestas.

19/07/2019 1.6 Operación Sujeta a Detracción y Detracción Servicios de Transporte Carga

28/10/2019 1.8 Agregado Tipo de operación: Operación Sujeta a Percepción

30/03/2020 1.9 Agregado IVAP

11/04/2020 2.0 Agregados nuevos tipos de Detracción

15/04/2020 2.1 Agregado Medios de Pago para operaciones de Detracciones

Operación Sujeta a Detracción Servicios de Transporte de Pasajeros y Detracción de Recursos

CONSTRUIR UN ARCHIVO TXT 3

EJEMPLOS DE ARCHIVOS TXT 5

EJEMPLOS DE CÓDIGO EN LENGUAJES DE PROGRAMACIÓN 6

ESTRUCTURA DE ARCHIVOS TXT 7

VERSIONES DE NUBEFACT PARA USAR NUESTRA API.

FORMATOS O ARCHIVOS SOPORTADOS

RUTA: Cada cliente tiene una RUTA distinta y única.

CONSEGUIR UNA CUENTA DEMO EN NUBEFACT

CÓMO USAR LA RUTA Y EL TOKEN

1. Todas las solicitudes se hacen vía ​POST​ a la RUTA, ejemplo: ​https://www.nubefact.com/api/v1/48239908-7ae7-071765d4

HERRAMIENTAS PARA LA RUTA Y EL TOKEN:

CONSTRUIR UN ARCHIVO TXT

Se pueden hacer​ 4 tipos de operaciones​ con nuestra API:

OPERACIÓN 1: GENERAR FACTURAS, BOLETAS Y NOTAS CON TXT

TXT PARA ENVIAR A NUBEFACT TXT DE RESPUESTA DE NUBEFACT

OPERACIÓN 2: CONSULTAR FACTURAS, BOLETAS Y NOTAS CON TXT

TXT PARA ENVIAR A NUBEFACT TXT DE RESPUESTA DE NUBEFACT

OPERACIÓN 3: ANULAR FACTURAS, BOLETAS Y NOTAS CON TXT

TXT PARA ENVIAR A NUBEFACT TXT DE RESPUESTA DE NUBEFACT

OPERACIÓN 4: CONSULTAR ANULACIÓN DE FACTURAS, BOLETAS Y NOTAS CON TXT

TXT PARA ENVIAR A NUBEFACT TXT DE RESPUESTA DE NUBEFACT

EJEMPLOS DE ARCHIVOS TXT

EJEMPLOS DE CÓDIGO EN LENGUAJES DE PROGRAMACIÓN

VISUAL FOX PRO

No dudes en contactarnos de existir alguna pregunta o inquietud.

FORMATO o TAMAÑO A4 FORMATO o TAMAÑO A5 (MITAD DE A4) FORMATO TICKET

REPRESENTACIÓN IMPRESA PROPIA:

A. Número de RUC del emisor electrónico.

● 1 Factura Electrónica para Exportación

ESTRUCTURA DE ARCHIVOS TXT

6 = RUC - REGISTRO ÚNICO DE CONTRIBUYENTE

0 = NO DOMICILIADO, SIN RUC (EXPORTACIÓN)

Dirección completa (OPCIONAL en caso de ser una

1 = PERCEPCIÓN VENTA INTERNA - TASA 2%

false = FALSO (En minúsculas)

Texto de 0 hasta 1000 caracteres. Si se desea saltos de XXXXX <br>

documento_que_se_modifica 1 = FACTURAS ELECTRÓNICAS

documento_que_se_modifica SERIE de la FACTURA o BOLETA que se modifica

1 = 001 Azúcar y melaza de caña

11 = 011 Bienes gravados con el IGV, o renuncia a la

Código de Ubigeo de Origen:

Punto de destino del viaje.(SOLO EN TIPO

Descripción del tramo.(SOLO EN TIPO DETRACCIÓN

Indicador de aplicación de factor de retorno al

Para consultas escribir a [email protected] o al WhatsApp 924 353365

1. Todas las solicitudes se hacen vía POST a la RUTA, ejemplo: https://www.nubefact.com/api/v1/48239908-7ae7-071765d4

Se pueden hacer 4 tipos de operaciones con nuestra API:

errors|El archivo enviado no cumple con el formato establecido|