www.fastura.pe soporte@fastura.

pe

DOCUMENTACIÓN API REST

Fastura V 2.0

Factúralo Perú
2019

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

ÍNDICE

1. INTRODUCCIÓN 4

2. ACCESO 4
2.1 USO DE LA URL Y TOKEN 5
2.2 SUGERENCIAS 5
2.3 OPERACIONES 5

3. RESPUESTA API 6

4. GENERAR FACTURAS 7
4.1 FACTURA GRAVADA 7
4.2 FACTURA INAFECTA 9
4.3 FACTURA GRAVADA - GRATUITA 11
4.4 FACTURA GRAVADA EN DÓLARES 13
4.5 FACTURA GRATUITA 15
4.6 FACTURA EXONERADA 17
4.7 FACTURA GRAVADA SIN ENVIAR 19
4.8 ENVIAR FACTURA GENERADA OFFLINE 21
4.9 FACTURA - DATOS ADICIONALES - GUIAS 22
4.10 FACTURA - D. ADICIONALES - DOC. RELACIONADOS 24
4.11 FACTURA - D. ADICIONALES A NIVEL DE ITEM 26

5. GENERAR BOLETAS 28
5.1 BOLETA GRAVADA 28

6. GENERAR NOTAS 30
6.1 NOTA CRÉDITO - FACTURA 30
6.2 NOTA DÉBITO - FACTURA 32

7. GENERAR RESÚMENES 34
7.1 REGISTRAR Y ENVIAR RESÚMEN 34
7.2 CONSULTAR TICKET 35

8. ANULACIÓN BOLETAS 36
8.1 REGISTRAR Y ENVIAR ANULACIÓN 36
8.2 CONSULTAR TICKET ANULACIÓN 37

9. ANULACIÓN FACTURAS - NOTAS 38

9.1 REGISTRAR Y ENVIAR ANULACIÓN 38
9.2 CONSULTAR TICKET ANULACIÓN 39

10. GUÍA DE REMISIÓN 40

10.1 GENERAR GUIA DE REMISIÓN 40

11. RETENCIÓN 42

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

11.1 GENERAR COMPROBANTE DE RETENCIÓN 42

12. OTRAS FUNCIONALIDADES 45

12.1 ENVIAR COMPROBANTE POR CORREO ELECTRÓNICO 45
12.2 CAMBIAR FORMATO DE REPRESENTACION IMPRESA 46

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

1. INTRODUCCIÓN
Para la implementación de la Facturación Electrónica, la SUNAT ha puesto a su
disposición diversos manuales y documentos técnicos, los cuales inicialmente son
complejos de entender y utilizar. El objetivo de Fastura es brindar una API que
simplifique el proceso a los desarrolladores para cumplir con las pautas que exige la
SUNAT, de una manera más eficiente, y a la vez pueda implementarlo haciendo uso de
cualquier lenguaje de programación.

La api de Fastura le permitirá generar diversos documentos electrónicos, y de cada uno

obtendrá los 3 archivos indispensables (XML Firmado, Documento PDF, y CDR).

Los documentos que se encuentran contemplados son:

1. Factura

2. Boleta

3. Nota de Débito

4. Nota de Crédito

5. Resúmenes

6. Anulaciones

7. Comprobante de retención

8. Guia de remision

2. ACCESO
El servicio se encuentra protegido con el fin de mantener la integridad y
confidencialidad de la información.

Inicialmente para hacer el uso de la api, necesitas un token y la url.

● URL: http://demo.2facturaloperuonline.com/api/documents
● TOKEN: ZRRxdDZ41gkGcHrnbxk4NZqTezbhDxXnddZfTqyy7zQNBm49rT

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

2.1 USO DE LA URL Y TOKEN

1. Las peticiones a la API se realizan vía POST

2. Debes enviar en el HEADER de tu solicitud la siguiente lo siguiente:
Authorization
Bearer ZRRxdDZ41gkGcHrnbxk4NZqTezbhDxXnddZfTqyy7zQNBm49rT
Content-Type application/json
3. Ingresar en el body o cuerpo el JSON.
4. Finalmente recibirás la respuesta.

Nota: Tenga en cuenta que mediante el api token que usted envie se identificará al
establecimiento, el cual irá relacionado al comprobante electronico que emita. Debido a
que 1 usuario esta relacionado a 1 establecimiento. Se encuentran comtemplados los
siguientes documentos: Facturas, Boletas y Notas.

2.2 SUGERENCIAS
● Realice las pruebas enviando directamente el JSON, usando POSTMAN o la
herramienta de su preferencia
● Valide si la estructura del JSON es correcta
● Valide si los datos del JSON son correctos
● Inicie la integración de la API con su aplicativo

Recomendamos construir el archivo JSON teniendo en cuenta las especificaciones

indicadas en http://json.org; y los datos correctos en cada atributo del JSON.

El archivo debe ser construido de tal forma que:

● Sea construido en codificación UTF-8.
● No tenga caracteres especiales o espacios innecesarios.
● La suma de cada línea del comprobante debe coincidir con los totales.

2.3 OPERACIONES

Las diveras operaciones que se pueden realizar con nuestra API se muestran a partir del
punto 4.

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

3. RESPUESTA API

ESTRUCTURA JSON RESPUESTA

"success": true, => Proceso ejecutado correctamente

"data": {
"number": "F001-4", => Serie y número del documento emitido
"filename": "20415963255-01-F001-4", => Nombre de documento
"external_id": "7eff377b-de6c-4af3-ba6a-893ca5f94677", => Código único, para
comunicación con API

"number_to_letter": "Ciento dieciocho con 00/100 ", => Monto en letras (Leyendas)
"hash": "7YhwG4nbDE3TCP4AhgzE/1shijc=", => Usar para modificar la representación
impresa (PDF)

"qr": "iVBORw0KGgoAAAANSUhEUgAAAJY" => Usar para modificar la representacion

impresa (PDF)
},

"links": {
"xml": "http://demo26.multifacturalonew.oo:8084/downloads/document/xml/7eff377b-
de6c-4af3-ba6a-893ca5f94677", => Enlace de descarga del XML firmado

"pdf": "http://demo26.multifacturalonew.oo:8084/downloads/document/pdf/7eff377b-
de6c-4af3-ba6a-893ca5f94677", => Enlace de descarga del PDF

"cdr": "http://demo26.multifacturalonew.oo:8084/downloads/document/cdr/7eff377b-
de6c-4af3-ba6a-893ca5f94677" => Enlace de descarga del CDR

},

"response": {
"code": "0",
"description": "La Factura número F001-4, ha sido aceptada", => Respuesta Sunat
"notes": []
}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

4. GENERAR FACTURAS

4.1 FACTURA GRAVADA

La Factura Electrónica es un comprobante de pago emitido a través del sistema
de emisión electrónica desarrollado desde los sistemas del contribuyente y que
permite la sustentación del costo-gasto para efectos del Impuesto a la Renta, así
como la utilización del crédito fiscal del Impuesto General a las Ventas.

Ejemplo:

JSON A ENVIAR

{
"serie_documento": "F001",
"numero_documento": "#",
"fecha_de_emision": "2018-10-09",
"hora_de_emision": "10:11:11",
"codigo_tipo_operacion": "0101",
"codigo_tipo_documento":"01",
"codigo_tipo_moneda": "PEN",
"fecha_de_vencimiento":"2018-08-30",
"numero_orden_de_compra": "0045467898",
"datos_del_cliente_o_receptor":{
"codigo_tipo_documento_identidad": "6",
"numero_documento": "10414711225",
"apellidos_y_nombres_o_razon_social": "EMPRESA XYZ S.A.",
"codigo_pais": "PE",
"ubigeo": "150101",
"direccion": "Av. 2 de Mayo",
"correo_electronico": "demo@gmail.com",
"telefono": "427-1148"
},
"totales": {
"total_exportacion": 0.00,
"total_operaciones_gravadas": 100.00,
"total_operaciones_inafectas": 0.00,
"total_operaciones_exoneradas": 0.00,
"total_operaciones_gratuitas": 0.00,
"total_igv": 18.00,
"total_impuestos": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{
"codigo_interno": "P0121",
"descripcion":"Inca Kola 250 ml",
"codigo_producto_sunat": "51121703",
"unidad_de_medida": "NIU",
"cantidad": 2,
"valor_unitario": 50,

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

"codigo_tipo_precio": "01",
"precio_unitario": 59,
"codigo_tipo_afectacion_igv": "10",
"total_base_igv": 100.00,
"porcentaje_igv": 18,
"total_igv": 18,
"total_impuestos": 18,
"total_valor_item": 100,
"total_item": 118
}
],
"informacion_adicional": "Forma de pago:Efectivo|Caja: 1"
}

JSON RESPUESTA

{
"success": true,
"data": {
"number": "F001-5",
"filename": "20415963255-01-F001-5",
"external_id": "103c8710-6c6e-4b7b-8d7b-c59f642c7a71",
"number_to_letter": "Ciento dieciocho con 00/100 ",
"hash": "gLOlpznxBvvhT/BUUugMYDhQo84=",
"qr":
"iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAIAAACzY+a1AAAACXBIWXMAAA7EAAA
OxAGVKw4bAAAEgklEQVR4nO2d3XYbMQgG4568/yund45bqwQBWneOZy7t1U/yHZA
WIXz7+vr6EDK/Xj0B6aKEeJQQjxLiUUI8SohHCfEoIR4lxKOEeJQQjxLi+Uw+d7vd+oM9htT
vHd4/fBzi+="
},
"links": {
"xml":
"http://demo26.multifacturalonew.oo:8084/downloads/document/xml/103c8710-6c6e-
4b7b-8d7b-c59f642c7a71",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/document/pdf/103c8710-6c6e-
4b7b-8d7b-c59f642c7a71",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/document/cdr/103c8710-6c6e-
4b7b-8d7b-c59f642c7a71"
},
"response": {
"code": "0",
"description": "La Factura numero F001-5, ha sido aceptada",
"notes": []
}
}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

4.2 FACTURA INAFECTA

La inafectación contenida en las normas del impuesto establece que
operaciones y servicios no están gravadas con el IGV .

Ejemplo:

JSON A ENVIAR

{
"serie_documento": "F001",
"numero_documento": "#",
"fecha_de_emision": "2018-10-09",
"hora_de_emision": "10:11:11",
"codigo_tipo_operacion": "0101",
"codigo_tipo_documento":"01",
"codigo_tipo_moneda": "PEN",
"fecha_de_vencimiento":"2018-08-30",
"numero_orden_de_compra": "0045467898",
"datos_del_cliente_o_receptor":{
"codigo_tipo_documento_identidad": "6",
"numero_documento": "10414711225",
"apellidos_y_nombres_o_razon_social": "EMPRESA XYZ S.A.",
"codigo_pais": "PE",
"ubigeo": "150101",
"direccion": "Av. 2 de Mayo",
"correo_electronico": "demo@gmail.com",
"telefono": "427-1148"
},
"totales": {
"total_exportacion": 0.00,
"total_operaciones_gravadas": 0.00,
"total_operaciones_inafectas": 118.00,
"total_operaciones_exoneradas": 0.00,
"total_operaciones_gratuitas": 0.00,
"total_igv": 0.00,
"total_impuestos": 0.00,
"total_valor": 118,
"total_venta": 118
},
"items":[
{
"codigo_interno": "P0121",
"descripcion":"Inca Kola 250 ml",
"codigo_producto_sunat": "",
"codigo_producto_gsl": "",
"unidad_de_medida": "NIU",
"cantidad": 2,
"valor_unitario": 59,
"codigo_tipo_precio": "01",
"precio_unitario": 59,
"codigo_tipo_afectacion_igv": "30",
"total_base_igv": 0.00,
"porcentaje_igv": 18,

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

"total_igv": 0.00,
"total_impuestos": 0.00,
"total_valor_item": 118,
"total_item": 118
}
]
}

JSON RESPUESTA

{
"success": true,
"data": {
"number": "F001-7",
"filename": "20415963255-01-F001-7",
"external_id": "c6057c05-6ec8-44d0-9fb9-23159498ce8e",
"number_to_letter": "Ciento dieciocho con 00/100 ",
"hash": "wE4GOpgMM/ckUGdA7Qv2UzJYe70=",
"qr": "iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAIAAACwzDwIJ7bkt"
},
"links": {
"xml":
"http://demo26.multifacturalonew.oo:8084/downloads/document/xml/c6057c05-6ec8-
44d0-9fb9-23159498ce8e",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/document/pdf/c6057c05-6ec8-
44d0-9fb9-23159498ce8e",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/document/cdr/c6057c05-6ec8-
44d0-9fb9-23159498ce8e"
},
"response": {
"code": "0",
"description": "La Factura numero F001-7, ha sido aceptada",
"notes": []
}
}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

4.3 FACTURA GRAVADA - GRATUITA

Generar una factura con item gravado y gratuito.

Ejemplo:

JSON A ENVIAR

{
"serie_documento": "F001",
"numero_documento": "#",
"fecha_de_emision": "2018-10-09",
"hora_de_emision": "10:11:11",
"codigo_tipo_operacion": "0101",
"codigo_tipo_documento":"01",
"codigo_tipo_moneda": "PEN",
"fecha_de_vencimiento": "2018-10-09",
"numero_orden_de_compra": "0045467898",
"datos_del_cliente_o_receptor":{
"codigo_tipo_documento_identidad": "6",
"numero_documento": "10414711225",
"apellidos_y_nombres_o_razon_social": "EMPRESA XYZ S.A.",
"codigo_pais": "PE",
"ubigeo": "150101",
"direccion": "Av. 2 de Mayo",
"correo_electronico": "demo@gmail.com",
"telefono": "427-1148"
},
"totales": {
"total_exportacion": 0.00,
"total_operaciones_gravadas": 100.00,
"total_operaciones_inafectas": 0.00,
"total_operaciones_exoneradas": 0.00,
"total_operaciones_gratuitas": 100.00,
"total_igv": 18.00,
"total_impuestos": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{
"codigo_interno": "P0121",
"descripcion":"Inca Kola 250 ml",
"codigo_producto_sunat": "",
"codigo_producto_gsl": "",
"unidad_de_medida": "NIU",
"cantidad": 2,
"valor_unitario": 50,
"codigo_tipo_precio": "01",
"precio_unitario": 59,
"codigo_tipo_afectacion_igv": "10",
"total_base_igv": 100.00,
"porcentaje_igv": 18,

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

"total_igv": 18,
"total_impuestos": 18,
"total_valor_item": 100,
"total_item": 118
},
{
"codigo_interno": "P0122",
"descripcion":"Pepsi 250 ml",
"codigo_producto_sunat": "",
"codigo_producto_gsl": "",
"unidad_de_medida": "NIU",
"cantidad": 2,
"valor_unitario": 0.00,
"codigo_tipo_precio": "02",
"precio_unitario": 0.00,
"codigo_tipo_afectacion_igv": "16",
"total_base_igv": 100.00,
"porcentaje_igv": 18.00,
"total_igv": 18.00,
"total_impuestos": 0.00,
"total_valor_item": 0.00,
"total_item": 0.00
}
]
}

JSON RESPUESTA

{
"success": true,
"data": {
"number": "F001-8",
"filename": "20415963255-01-F001-8",
"external_id": "9877a32d-b285-4f4a-9a8f-6b01e3d3621b",
"number_to_letter": "Ciento dieciocho con 00/100 ",
"hash": "P4wuH5ZRD5itfP903wo1V9jwuLw=",
"qr": "iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAIAAAC="
},
"links": {
"xml":
"http://demo26.multifacturalonew.oo:8084/downloads/document/xml/9877a32d-b285-
4f4a-9a8f-6b01e3d3621b",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/document/pdf/9877a32d-b285-
4f4a-9a8f-6b01e3d3621b",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/document/cdr/9877a32d-b285-
4f4a-9a8f-6b01e3d3621b"
},
"response": {
"code": "0",
"description": "La Factura numero F001-8, ha sido aceptada",
"notes": [] }}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

4.4 FACTURA GRAVADA EN DÓLARES

Ejemplo:

JSON A ENVIAR

{
"serie_documento": "F001",
"numero_documento": "#",
"fecha_de_emision": "2018-10-09",
"hora_de_emision": "10:11:11",
"codigo_tipo_operacion": "0101",
"codigo_tipo_documento":"01",
"codigo_tipo_moneda": "USD",
"fecha_de_vencimiento": "2018-10-09",
"numero_orden_de_compra": "0045467898",
"datos_del_cliente_o_receptor":{
"codigo_tipo_documento_identidad": "6",
"numero_documento": "10414711225",
"apellidos_y_nombres_o_razon_social": "EMPRESA XYZ S.A.",
"codigo_pais": "PE",
"ubigeo": "150101",
"direccion": "Av. 2 de Mayo",
"correo_electronico": "demo@gmail.com",
"telefono": "427-1148"
},
"totales": {
"total_exportacion": 0.00,
"total_operaciones_gravadas": 100.00,
"total_operaciones_inafectas": 0.00,
"total_operaciones_exoneradas": 0.00,
"total_operaciones_gratuitas": 0.00,
"total_igv": 18.00,
"total_impuestos": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{
"codigo_interno": "P0121",
"descripcion":"Inca Kola 250 ml",
"codigo_producto_sunat": "",
"codigo_producto_gsl": "",
"unidad_de_medida": "NIU",
"cantidad": 2,
"valor_unitario": 50,
"codigo_tipo_precio": "01",
"precio_unitario": 59,
"codigo_tipo_afectacion_igv": "10",
"total_base_igv": 100.00,
"porcentaje_igv": 18,
"total_igv": 18,
"total_impuestos": 18,

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

"total_valor_item": 100,
"total_item": 118
}
]
}

JSON RESPUESTA

{
"success": true,
"data": {
"number": "F001-9",
"filename": "20415963255-01-F001-9",
"external_id": "085582cc-953c-4609-8078-d682ef17a19d",
"number_to_letter": "Ciento dieciocho con 00/100 ",
"hash": "wvkARde8TKhPpxDjVfEXTAPciiM=",
"qr":
"iVBORw0KGgoAAAANSUhEUgAAD6vetJt+ef8amAr5AwnjMd+2vq4Soj2pyzXPX99qTEF
mRviNIGA8SxrO9qbB17NhU1E9urOlvPp0u4Mj3jUDCeMxXRGuWFV6WXUzq/p6/1Z3Srot
uRPC9/vYDK/wPQMJ47rgiOnF3N1TnrburnX89qroL6s7AF0gYDxLGM8qdsdS1FafARlK9X
oxGHFWNNxmH6MwbgYTx3JGEuGSSSHjDwWzjQHj3JizlEuALJIznZY70YOKyJk++oQhXI
0WxAVYYDxLGg4TxjOZCizdvnIseWK44Ne4ti+j186k789YgYTzbjvTmOriNLccN5RLELhoX
EBptscJ4kDCel2VzgwusMB4kjAcJ40HCeJAwHiSMBwnjQcJ4kDAeJIwHCeNBwniQMJ4/
+yPKFTSawdUAAAAASUVORK5CYII="
},
"links": {
"xml":
"http://demo26.multifacturalonew.oo:8084/downloads/document/xml/085582cc-953c-
4609-8078-d682ef17a19d",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/document/pdf/085582cc-953c-
4609-8078-d682ef17a19d",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/document/cdr/085582cc-953c-
4609-8078-d682ef17a19d"
},
"response": {
"code": "0",
"description": "La Factura numero F001-9, ha sido aceptada",
"notes": []
}
}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

4.5 FACTURA GRATUITA

Ejemplo:

JSON A ENVIAR

{
"serie_documento": "F001",
"numero_documento": "#",
"fecha_de_emision": "2018-10-09",
"hora_de_emision": "10:11:11",
"codigo_tipo_operacion": "0101",
"codigo_tipo_documento":"01",
"codigo_tipo_moneda": "PEN",
"fecha_de_vencimiento":"2018-08-30",
"numero_orden_de_compra": "0045467898",
"datos_del_cliente_o_receptor":{
"codigo_tipo_documento_identidad": "6",
"numero_documento": "10414711225",
"apellidos_y_nombres_o_razon_social": "EMPRESA XYZ S.A.",
"codigo_pais": "PE",
"ubigeo": "150101",
"direccion": "Av. 2 de Mayo",
"correo_electronico": "demo@gmail.com",
"telefono": "427-1148"
},
"totales": {
"total_exportacion": 0.00,
"total_operaciones_gravadas": 0.00,
"total_operaciones_inafectas": 0.00,
"total_operaciones_exoneradas": 0.00,
"total_operaciones_gratuitas": 100.00,
"total_igv": 0.00,
"total_impuestos": 0.00,
"total_valor": 0.00,
"total_venta": 0.00
},
"items":[
{
"codigo_interno": "P0121",
"descripcion":"Inca Kola 250 ml",
"codigo_producto_sunat": "",
"codigo_producto_gsl": "",
"unidad_de_medida": "NIU",
"cantidad": 2,
"valor_unitario": 0.00,
"codigo_tipo_precio": "02",
"precio_unitario": 0.00,
"codigo_tipo_afectacion_igv": "16",
"total_base_igv": 100.00,
"porcentaje_igv": 18.00,
"total_igv": 18.00,
"total_impuestos": 0.00,

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

"total_valor_item": 0.00,
"total_item": 0.00
}
],
"leyendas": [
{
"codigo": "1002",
"valor": "TRANSFERENCIA GRATUITA"
}
]
}

JSON RESPUESTA

{
"success": true,
"data": {
"number": "F001-14",
"filename": "20415963255-01-F001-14",
"external_id": "7777062c-a22a-4d2c-925e-94063f3d4596",
"number_to_letter": "Cero con 00/100 ",
"hash": "G+O3Qn2FvoYmj4aDYu19lOIvCx0=",
"qr":
"iVBORw0KGHVPYHBA3SAu5oOKcNF731FmQYIX2IKE9wyWiBcQIi/5yn+03ZiptPmikCVZ
oDxLac1s2N0yBFdqDhPYgoT1IaA8S2oOE9iChPUhoDxLag4T2IKE9SGgPEtrzDwHhDzxi9
N5VAAAAAElFTkSuQmCC"
},
"links": {
"xml":
"http://demo26.multifacturalonew.oo:8084/downloads/document/xml/7777062c-a22a-
4d2c-925e-94063f3d4596",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/document/pdf/7777062c-a22a-
4d2c-925e-94063f3d4596",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/document/cdr/7777062c-a22a-
4d2c-925e-94063f3d4596"
},
"response": {
"code": "0",
"description": "La Factura numero F001-14, ha sido aceptada",
"notes": []
}
}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

4.6 FACTURA EXONERADA

Entendemos por exoneradas a aquellas operaciones que, no obstante
encontrarse afectas en principio al impuesto, por mandato de la misma ley
quedan liberadas del pago del tributo.

Ejemplo:

JSON A ENVIAR

{
"serie_documento": "F001",
"numero_documento": "#",
"fecha_de_emision": "2018-10-09",
"hora_de_emision": "10:11:11",
"codigo_tipo_operacion": "0101",
"codigo_tipo_documento":"01",
"codigo_tipo_moneda": "PEN",
"fecha_de_vencimiento":"2018-08-30",
"numero_orden_de_compra": "0045467898",
"datos_del_cliente_o_receptor":{
"codigo_tipo_documento_identidad": "6",
"numero_documento": "10414711225",
"apellidos_y_nombres_o_razon_social": "EMPRESA XYZ S.A.",
"codigo_pais": "PE",
"ubigeo": "150101",
"direccion": "Av. 2 de Mayo",
"correo_electronico": "demo@gmail.com",
"telefono": "427-1148"
},
"totales": {
"total_exportacion": 0.00,
"total_operaciones_gravadas": 0.00,
"total_operaciones_inafectas": 0.00,
"total_operaciones_exoneradas": 118.00,
"total_operaciones_gratuitas": 0.00,
"total_igv": 0.00,
"total_impuestos": 0.00,
"total_valor": 118,
"total_venta": 118
},
"items":[
{
"codigo_interno": "P0121",
"descripcion":"Inca Kola 250 ml",
"codigo_producto_sunat": "",
"codigo_producto_gsl": "",
"unidad_de_medida": "NIU",
"cantidad": 2,
"valor_unitario": 59,
"codigo_tipo_precio": "01",
"precio_unitario": 59,
"codigo_tipo_afectacion_igv": "20",
"total_base_igv": 0.00,

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

"porcentaje_igv": 18,
"total_igv": 0.00,
"total_impuestos": 0.00,
"total_valor_item": 118,
"total_item": 118
}
]
}

JSON RESPUESTA

{
"success": true,
"data": {
"number": "F001-17",
"filename": "20415963255-01-F001-17",
"external_id": "5a3b1a7e-2c71-4d20-b808-50ea0a82d6d2",
"number_to_letter": "Ciento dieciocho con 00/100 ",
"hash": "tXp3cesBNfVwKXqm/b3kW84Q5vE=",
"qr":
"iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAIAAACzY+a1AAAACXBIWXMAAA7EAAA
OxAGVKw4bAAAEZElEQVR4nO2dwW7jMAxEk0X//5e7l0UQ1FyV4oydDPLesbElJQNSEk
Wx9+/v7xsk8+fVAwAVJIwHCeNBwniQMB4kjAcJ40HCeJAwHiS7vSJtRPEsaDhPEgYTxIG
M9fuiMPDwbdPS0AAAAASUVORK5CYII="
},
"links": {
"xml":
"http://demo26.multifacturalonew.oo:8084/downloads/document/xml/5a3b1a7e-2c71-
4d20-b808-50ea0a82d6d2",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/document/pdf/5a3b1a7e-2c71-
4d20-b808-50ea0a82d6d2",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/document/cdr/5a3b1a7e-2c71-
4d20-b808-50ea0a82d6d2"
},
"response": {
"code": "0",
"description": "La Factura numero F001-17, ha sido aceptada",
"notes": []
}
}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

4.7 FACTURA GRAVADA SIN ENVIAR

Puede generar una factura sin enviarla a sunat (offline), en caso no cuente con
internet, puede generar el xml y pdf normalmente. Y en un momento posterior
enviarla a sunat, y obtener el CDR respectivo.

Ejemplo:

JSON A ENVIAR

{
"serie_documento": "F001",
"numero_documento": "#",
"fecha_de_emision": "2018-10-09",
"hora_de_emision": "10:11:11",
"codigo_tipo_operacion": "0101",
"codigo_tipo_documento":"01",
"codigo_tipo_moneda": "PEN",
"fecha_de_vencimiento":"2018-08-30",
"numero_orden_de_compra": "0045467898",
"datos_del_cliente_o_receptor":{
"codigo_tipo_documento_identidad": "6",
"numero_documento": "10414711225",
"apellidos_y_nombres_o_razon_social": "EMPRESA XYZ S.A.",
"codigo_pais": "PE",
"ubigeo": "150101",
"direccion": "Av. 2 de Mayo",
"correo_electronico": "demo@gmail.com",
"telefono": "427-1148"
},
"totales": {
"total_exportacion": 0.00,
"total_operaciones_gravadas": 100.00,
"total_operaciones_inafectas": 0.00,
"total_operaciones_exoneradas": 0.00,
"total_operaciones_gratuitas": 0.00,
"total_igv": 18.00,
"total_impuestos": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{
"codigo_interno": "P0121",
"descripcion":"Inca Kola 250 ml",
"codigo_producto_sunat": "51121703",
"unidad_de_medida": "NIU",
"cantidad": 2,
"valor_unitario": 50,
"codigo_tipo_precio": "01",
"precio_unitario": 59,
"codigo_tipo_afectacion_igv": "10",
"total_base_igv": 100.00,
"porcentaje_igv": 18,

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

"total_igv": 18,
"total_impuestos": 18,
"total_valor_item": 100,
"total_item": 118
}
],
"acciones": {
"enviar_xml_firmado": false
}
}

JSON RESPUESTA

{
"success": true,
"data": {
"number": "F001-15",
"filename": "20415963255-01-F001-15",
"external_id": "7d9feb66-16e9-47a9-86fd-ebccdb662678",
"number_to_letter": "Ciento dieciocho con 00/100 ",
"hash": "WnFNru/saJAiNBfRZeYrxxbcTEQ=",
"qr":
"iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAIAAACzY+a1AAAACXBIWXMAAA7EAAA
OxAGVKw4bAAAEbUlEQVR4nO2d227jMAxEm8X+/y9334IAVhmKM3Y663MeE+vSDEhZF
MU+vr+/vyCZP5+eAKggYTxIGA8SxoOE8SBhPEgYDxLGg4TxIGE8SBgPEsbzt/nc4/HQB3s
NqR87HATcl7M69mOZ/LLnJfbfqgYrjAcJ4+k60ifnubsBzU76Y7lc7u64ygSwwniQMB4kjG
d7LXyldtz1SvBsu3ysuSQMhjh++DrW7oakbtvvR3kzwArjQcJ4JEdqofaotZtteqfa3aWnYWK
F8SBhPJ93pE/6gQklkL37Rlp78t/ghLHCeJAwHiSMR1oLlZXguBT1byNQfCWGE8SBiPFOb
e9Z/9yI5y5Fuz28Se/9JcVghz3wgkjEeKzjTvoVtc1uDbQargbrx+cD7qDQ99YYX/AUgYDxLG
Y95U2E9K7YnxSoTl2IlyM9kFVhgPEsYjbSpqmkHwerhjb8sOXSn3nZksO+nPyn6JA="
},
"links": {
"xml":
"http://demo26.multifacturalonew.oo:8084/downloads/document/xml/7d9feb66-16e9-
47a9-86fd-ebccdb662678",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/document/pdf/7d9feb66-16e9-
47a9-86fd-ebccdb662678",
"cdr": ""
},
"response": []
}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

4.8 ENVIAR FACTURA GENERADA OFFLINE

Para enviar a Sunat la factura generada en modo offline, puede usar el siguiente
servicio, necesitará la url, el token y el external_id del documento generado.

Url: http://demo.2facturaloperuonline.com/api/documents/send
Token: ZRRxdDZ41gkGcHrnbxk4NZqTezbhDxXnddZfTqyy7zQNBm49rT

Ejemplo:

JSON A ENVIAR

{
"external_id": "4812b6e7-352d-4926-8409-3a8a6b02bb94"
}

JSON RESPUESTA

{
"success": true,
"data": {
"number": "F001-15",
"filename": "20415963255-01-F001-15",
"external_id": "7d9feb66-16e9-47a9-86fd-ebccdb662678"
},
"links": {
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/document/cdr/7d9feb66-16e9-
47a9-86fd-ebccdb662678"
},
"response": {
"code": "0",
"description": "La Factura numero F001-15, ha sido aceptada",
"notes": []
}
}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

4.9 FACTURA - DATOS ADICIONALES - GUIAS

Para añadir guias a la factura necesita agregar el siguiente arreglo al json
principal.

ARREGLO

"guias":[
{
"numero": "T001",
"codigo_tipo_documento": "09"
},
{
"numero": "T002",
"codigo_tipo_documento": "09"
}
]

Ejemplo:

JSON A ENVIAR

{
"serie_documento": "F001",
"numero_documento": "#",
"fecha_de_emision": "2019-02-21",
"hora_de_emision": "10:11:11",
"codigo_tipo_operacion": "0101",
"codigo_tipo_documento":"01",
"codigo_tipo_moneda": "PEN",
"fecha_de_vencimiento":"2019-02-21",
"numero_orden_de_compra": "0045467898",
"datos_del_cliente_o_receptor":{
"codigo_tipo_documento_identidad": "6",
"numero_documento": "10414711225",
"apellidos_y_nombres_o_razon_social": "EMPRESA XYZ S.A.",
"codigo_pais": "PE",
"ubigeo": "150101",
"direccion": "Av. 2 de Mayo",
"correo_electronico": "demo@gmail.com",
"telefono": "427-1148"
},
"guias":[
{
"numero": "T001",
"codigo_tipo_documento": "09"
},
{
"numero": "T002",
"codigo_tipo_documento": "09"

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

}
],
"totales": {
"total_exportacion": 0.00,
"total_operaciones_gravadas": 100.00,
"total_operaciones_inafectas": 0.00,
"total_operaciones_exoneradas": 0.00,
"total_operaciones_gratuitas": 0.00,
"total_igv": 18.00,
"total_impuestos": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{
"codigo_interno": "P0121",
"descripcion":"Inca Kola 250 ml",
"codigo_producto_sunat": "51121703",
"unidad_de_medida": "NIU",
"cantidad": 2,
"valor_unitario": 50,
"codigo_tipo_precio": "01",
"precio_unitario": 59,
"codigo_tipo_afectacion_igv": "10",
"total_base_igv": 100.00,
"porcentaje_igv": 18,
"total_igv": 18,
"total_impuestos": 18,
"total_valor_item": 100,
"total_item": 118
}
],
"informacion_adicional": "Forma de pago:Efectivo|Caja: 1"
}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

4.10 FACTURA - D. ADICIONALES - DOC. RELACIONADOS

Para añadir documentos relacionados a la factura necesita agregar el siguiente
arreglo al json principal.

ARREGLO

"relacionados":[
{
"numero": "12",
"codigo_tipo_documento": "01",
"monto": 150.00
},
{
"numero": "15",
"codigo_tipo_documento": "01",
"monto": 150.00
}
]

Ejemplo:

JSON A ENVIAR

{
"serie_documento": "F001",
"numero_documento": "#",
"fecha_de_emision": "2018-10-09",
"hora_de_emision": "10:11:11",
"codigo_tipo_operacion": "0101",
"codigo_tipo_documento":"01",
"codigo_tipo_moneda": "PEN",
"fecha_de_vencimiento":"2018-08-30",
"numero_orden_de_compra": "0045467898",
"datos_del_cliente_o_receptor":{
"codigo_tipo_documento_identidad": "6",
"numero_documento": "10414711225",
"apellidos_y_nombres_o_razon_social": "EMPRESA XYZ S.A.",
"codigo_pais": "PE",
"ubigeo": "150101",
"direccion": "Av. 2 de Mayo",
"correo_electronico": "demo@gmail.com",
"telefono": "427-1148"
},
"relacionados":[
{
"numero": "12",
"codigo_tipo_documento": "01",
"monto": 150.00
},

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

{
"numero": "15",
"codigo_tipo_documento": "01",
"monto": 150.00
}
],
"totales": {
"total_exportacion": 0.00,
"total_operaciones_gravadas": 100.00,
"total_operaciones_inafectas": 0.00,
"total_operaciones_exoneradas": 0.00,
"total_operaciones_gratuitas": 0.00,
"total_igv": 18.00,
"total_impuestos": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{
"codigo_interno": "P0121",
"descripcion":"Inca Kola 250 ml",
"codigo_producto_sunat": "51121703",
"unidad_de_medida": "NIU",
"cantidad": 2,
"valor_unitario": 50,
"codigo_tipo_precio": "01",
"precio_unitario": 59,
"codigo_tipo_afectacion_igv": "10",
"total_base_igv": 100.00,
"porcentaje_igv": 18,
"total_igv": 18,
"total_impuestos": 18,
"total_valor_item": 100,
"total_item": 118
}
],
"informacion_adicional": "Forma de pago:Efectivo|Caja: 1"
}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

4.11 FACTURA - D. ADICIONALES A NIVEL DE ITEM

Para añadir datos adicionales a nivel de item en la factura, necesita agregar el
siguiente arreglo al item.

ARREGLO

"datos_adicionales":[
{
"codigo": "5010",
"descripcion": "Numero de Placa",
"valor": "A7Q-986"
}
]

Puede añadir estos datos cuando necesita agregar atributos a los items de su
factura, en este caso el número de placa. Tenga en cuenta que el código debe ser
el correspondiente al catalogo de atributos brindado por sunat.

Ejemplo:

JSON A ENVIAR

{
"serie_documento": "F001",
"numero_documento": "#",
"fecha_de_emision": "2018-10-09",
"hora_de_emision": "10:11:11",
"codigo_tipo_operacion": "0101",
"codigo_tipo_documento":"01",
"codigo_tipo_moneda": "PEN",
"fecha_de_vencimiento":"2018-08-30",
"numero_orden_de_compra": "0045467898",
"datos_del_cliente_o_receptor":{
"codigo_tipo_documento_identidad": "6",
"numero_documento": "10414711225",
"apellidos_y_nombres_o_razon_social": "EMPRESA XYZ S.A.",
"codigo_pais": "PE",
"ubigeo": "150101",
"direccion": "Av. 2 de Mayo",
"correo_electronico": "demo@gmail.com",
"telefono": "427-1148"
},
"totales": {
"total_exportacion": 0.00,
"total_operaciones_gravadas": 100.00,
"total_operaciones_inafectas": 0.00,
"total_operaciones_exoneradas": 0.00,

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

"total_operaciones_gratuitas": 0.00,
"total_igv": 18.00,
"total_impuestos": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{
"codigo_interno": "P0121",
"descripcion":"Inca Kola 250 ml",
"codigo_producto_sunat": "51121703",
"unidad_de_medida": "NIU",
"cantidad": 2,
"valor_unitario": 50,
"codigo_tipo_precio": "01",
"precio_unitario": 59,
"codigo_tipo_afectacion_igv": "10",
"total_base_igv": 100.00,
"porcentaje_igv": 18,
"total_igv": 18,
"total_impuestos": 18,
"total_valor_item": 100,
"total_item": 118,
"datos_adicionales":[
{
"codigo": "5010",
"descripcion": "Numero de Placa",
"valor": "A7Q-986"
}
]
}
],
"informacion_adicional": "Forma de pago:Efectivo|Caja: 1"
}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

5. GENERAR BOLETAS

5.1 BOLETA GRAVADA

Venta gravada de productos o servicios en cualquiera de las etapas de producción
y distribución. Productos o servicios afectos al IGV (Impuesto General a la Venta).

Ejemplo:

JSON A ENVIAR

{
"serie_documento": "B001",
"numero_documento": "#",
"fecha_de_emision": "2018-10-09",
"hora_de_emision": "10:11:11",
"codigo_tipo_operacion": "0101",
"codigo_tipo_documento":"03",
"codigo_tipo_moneda": "PEN",
"fecha_de_vencimiento": "2018-10-09",
"numero_orden_de_compra": "0045467898",
"datos_del_cliente_o_receptor":{
"codigo_tipo_documento_identidad": "6",
"numero_documento": "10414711225",
"apellidos_y_nombres_o_razon_social": "EMPRESA XYZ S.A.",
"codigo_pais": "PE",
"ubigeo": "150101",
"direccion": "Av. 2 de Mayo",
"correo_electronico": "demo@gmail.com",
"telefono": "427-1148"
},
"totales": {
"total_exportacion": 0.00,
"total_operaciones_gravadas": 100.00,
"total_operaciones_inafectas": 0.00,
"total_operaciones_exoneradas": 0.00,
"total_operaciones_gratuitas": 0.00,
"total_igv": 18.00,
"total_impuestos": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{
"codigo_interno": "P0121",
"descripcion":"Inca Kola 250 ml",
"codigo_producto_sunat": "51121703",
"codigo_producto_gsl": "51121703",
"unidad_de_medida": "NIU",
"cantidad": 2,
"valor_unitario": 50,
"codigo_tipo_precio": "01",
"precio_unitario": 59,

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

"codigo_tipo_afectacion_igv": "10",
"total_base_igv": 100.00,
"porcentaje_igv": 18,
"total_igv": 18,
"total_impuestos": 18,
"total_valor_item": 100,
"total_item": 118
}
]
}

JSON RESPUESTA

{
"success": true,
"data": {
"number": "B001-1",
"filename": "20415963255-03-B001-1",
"external_id": "346135d8-b730-48e2-81f4-d00c9690f4ca",
"number_to_letter": "Ciento dieciocho con 00/100 ",
"hash": "T3/grz45f3rK5xz7/PtlrNuhlCo=",
"qr":
"iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAIAAACzY+a1AAAACXBIWXMAAA7EAAA
OxAGVKw4bAAAEaUlEQVR4nO2d23LbMAwF607//5fTt9QTswhIHMvZ8e5jJYtszwCicOvt4
+Pjl5D5/eoNyBQlxKOEeJQQjxLiUUI8SohHCfEoIR4lxKOEeJQQzdfVqdTI7308Zf+c3lLMh/R
5QQz8iRTpgElCdRkt3ez4MRD5Hb+miFeJQQz8sc6SOTmuvUeK8sk4bZPlohHiXEo4R4M
sMs40wiO3X/0e5akx7gVFdUjVaIRwnxPHGAV+SBF5TNHzi0ZmgplWqu0QrxKCGel1VzSw
qtEI8S4lFCPEqIRwnxKCEeJcSjhHiUEI8S4lFCPEqIRwnx/AV6e7I2Yyb8aQAAAABJRU5Erk
Jggg=="
},
"links": {
"xml":
"http://demo26.multifacturalonew.oo:8084/downloads/document/xml/346135d8-b730-
48e2-81f4-d00c9690f4ca",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/document/pdf/346135d8-b730-
48e2-81f4-d00c9690f4ca",
"cdr": ""
},
"response": []
}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

6. GENERAR NOTAS
En ocasiones, se producen errores en la emisión de facturas a compradores o clientes.
Esto provoca que estos errores se deban solventar con diferentes mecanismos, ya que la
Ley prohíbe la eliminación de facturas ya emitidas.

6.1 NOTA CRÉDITO - FACTURA

Una nota de crédito es un documento legal que se utiliza en transacciones de
compraventa donde interviene un descuento posterior a la emisión de la factura,
una anulación total, un cobro de un gasto incurrido de más, devolución de bienes.

Ejemplo:

JSON A ENVIAR

{
"serie_documento": "FC01",
"numero_documento": "#",
"fecha_de_emision": "2018-10-09",
"hora_de_emision": "10:11:11",
"codigo_tipo_documento":"07",
"codigo_tipo_nota": "01",
"motivo_o_sustento_de_nota": "Error al emitir comprobante",
"codigo_tipo_moneda": "PEN",
"numero_orden_de_compra": "0045467898",
"documento_afectado": {
"external_id": "e5d6896a-0c42-4ad3-a482-5616e7fe50fb"
},
"datos_del_cliente_o_receptor":{
"codigo_tipo_documento_identidad": "6",
"numero_documento": "10414711225",
"apellidos_y_nombres_o_razon_social": "EMPRESA XYZ S.A.",
"codigo_pais": "PE",
"ubigeo": "150101",
"direccion": "Av. 2 de Mayo",
"correo_electronico": "demo@gmail.com",
"telefono": "427-1148"
},
"totales": {
"total_exportacion": 0.00,
"total_operaciones_gravadas": 100.00,
"total_operaciones_inafectas": 0.00,
"total_operaciones_exoneradas": 0.00,
"total_operaciones_gratuitas": 0.00,
"total_igv": 18.00,
"total_impuestos": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

"codigo_interno": "P0121",
"descripcion":"Inca Kola 250 ml",
"codigo_producto_sunat": "",
"codigo_producto_gsl": "",
"unidad_de_medida": "NIU",
"cantidad": 2,
"valor_unitario": 50,
"codigo_tipo_precio": "01",
"precio_unitario": 59,
"codigo_tipo_afectacion_igv": "10",
"total_base_igv": 100.00,
"porcentaje_igv": 18,
"total_igv": 18,
"total_impuestos": 18,
"total_valor_item": 100,
"total_item": 118
}
]
}

JSON RESPUESTA

{
"success": true,
"data": {
"number": "FC01-1",
"filename": "20415963255-07-FC01-1",
"external_id": "92f5a566-512d-4159-b4c6-b6000e697328",
"number_to_letter": "Ciento dieciocho con 00/100 ",
"hash": "56/PpGEK7d59qsaqc+yZoxbBzqw=",
"qr":
"iVBORw0KGgoAAAANSUhEUgAAAJYL3vNWZ7DCeJAwHs/JJnghWGE8SBgPEsaDhPE
gYTxIGA8SxoOE8SBhPEgYDxLGg4TxIGE8fwFHMbVs99tbGwAAAABJRU5ErkJggg=="
},
"links": {
"xml":
"http://demo26.multifacturalonew.oo:8084/downloads/document/xml/92f5a566-512d-
4159-b4c6-b6000e697328",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/document/pdf/92f5a566-512d-
4159-b4c6-b6000e697328",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/document/cdr/92f5a566-512d-
4159-b4c6-b6000e697328"
},
"response": {
"code": "0",
"description": "La Nota de Crédito numero FC01-1, ha sido aceptada",
"notes": []
}}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

6.2 NOTA DÉBITO - FACTURA

Una de estas formas es la nota de débito y se utiliza cuando un comprador quiere
informar a un vendedor de que ha aumentado el precio de su deuda o que la
cantidad que había pagado era errónea y debe pagar más.

Ejemplo:

JSON A ENVIAR

{
"serie_documento": "FD01",
"numero_documento": "#",
"fecha_de_emision": "2018-10-09",
"hora_de_emision": "10:11:11",
"codigo_tipo_documento":"08",
"codigo_tipo_nota": "01",
"motivo_o_sustento_de_nota": "Error al emitir comprobante",
"codigo_tipo_moneda": "PEN",
"numero_orden_de_compra": "0045467898",
"documento_afectado": {
"external_id": "e5d6896a-0c42-4ad3-a482-5616e7fe50fb"
},
"datos_del_cliente_o_receptor":{
"codigo_tipo_documento_identidad": "6",
"numero_documento": "10414711225",
"apellidos_y_nombres_o_razon_social": "EMPRESA XYZ S.A.",
"codigo_pais": "PE",
"ubigeo": "150101",
"direccion": "Av. 2 de Mayo",
"correo_electronico": "demo@gmail.com",
"telefono": "427-1148"
},
"totales": {
"total_exportacion": 0.00,
"total_operaciones_gravadas": 100.00,
"total_operaciones_inafectas": 0.00,
"total_operaciones_exoneradas": 0.00,
"total_operaciones_gratuitas": 0.00,
"total_igv": 18.00,
"total_impuestos": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{
"codigo_interno": "P0121",
"descripcion":"Inca Kola 250 ml",
"codigo_producto_sunat": "51121703",
"codigo_producto_gsl": "51121703",
"unidad_de_medida": "NIU",
"cantidad": 2,
"valor_unitario": 50,

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

"codigo_tipo_precio": "01",
"precio_unitario": 59,
"codigo_tipo_afectacion_igv": "10",
"total_base_igv": 100.00,
"porcentaje_igv": 18,
"total_igv": 18,
"total_impuestos": 18,
"total_valor_item": 100,
"total_item": 118
}
]
}

JSON RESPUESTA

{
"success": true,
"data": {
"number": "FD01-1",
"filename": "20415963255-08-FD01-1",
"external_id": "72a16a9d-382a-4ca4-a1ba-fadfbd68f2fa",
"number_to_letter": "Ciento dieciocho con 00/100 ",
"hash": "cLYytvN0hmSxp8NIqKI4ULq0IH0=",
"qr":
"iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAIAAACzY+a1AAAACXBIWXMAAA7EAAA
OxAGVKw4bAAAEi0lEQVR4nO2d227jMAxEm0X//5U0RfcaBOzu4GLC9Af2BiLFcaDhPFcl
s0NLrDCeJAwHiSMBwnjQcJ4kDAeJIwHCeNBwniQMB4kjAcJ40HCeP4CPz+yVDvGghIA
AAAASUVORK5CYII="
},
"links": {
"xml":
"http://demo26.multifacturalonew.oo:8084/downloads/document/xml/72a16a9d-382a-
4ca4-a1ba-fadfbd68f2fa",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/document/pdf/72a16a9d-382a-
4ca4-a1ba-fadfbd68f2fa",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/document/cdr/72a16a9d-382a-
4ca4-a1ba-fadfbd68f2fa"
},
"response": {
"code": "0",
"description": "La Nota de Débito numero FD01-1, ha sido aceptada",
"notes": []
}
}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

7. GENERAR RESÚMENES

7.1 REGISTRAR Y ENVIAR RESÚMEN

Cuando se genera una boleta, esta no se envía inmediatamente a Sunat. Este
documento se envía mediante un resúmen, este puede contener 1 o más boletas,
para registrar y enviar el resúmen puede usar el siguiente servicio, necesitará la
url, el token y la fecha de emisión de las boletas que conformarán el resumen, es
decir mediante la fecha se consultará todas las boletas generadas.

Cuando haya culminado este procedimiento, deberá consultar el ticket del

resumen generado, se explicará en el siguiente punto.

Url: http://demo.2facturaloperuonline.com/api/summaries
Token: ZRRxdDZ41gkGcHrnbxk4NZqTezbhDxXnddZfTqyy7zQNBm49rT

Ejemplo:

JSON A ENVIAR

{
"fecha_de_emision_de_documentos": "2019-01-20",
"codigo_tipo_proceso": "1"
}

JSON RESPUESTA

{
"success": true,
"data": {
"external_id": "3832e508-fd01-4c8f-99dc-2ab83e9fd53e",
"ticket": "1548516520467"
}
}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

7.2 CONSULTAR TICKET

Para consultar el ticket del resumen generado puede usar el siguiente servicio,
necesitará la url, el token, el external_id (resumen) y el numero de ticket.

Url: http://demo.2facturaloperuonline.com/api/summaries/status
Token: ZRRxdDZ41gkGcHrnbxk4NZqTezbhDxXnddZfTqyy7zQNBm49rT

Cuando haya culminado este procedimiento, el resumen con la boletas que lo

conforman han sido aceptadas exitosamente por Sunat.

Ejemplo:

JSON A ENVIAR

{
"external_id": "f1b84991-ac67-444f-8201-b661a5807ca8",
"ticket": "1548198438506"
}

JSON RESPUESTA

{
"success": true,
"data": {
"filename": "20415963255-RC-20190126-5",
"external_id": "3832e508-fd01-4c8f-99dc-2ab83e9fd53e"
},
"links": {
"xml":
"http://demo26.multifacturalonew.oo:8084/downloads/summary/xml/3832e508-fd01-
4c8f-99dc-2ab83e9fd53e",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/summary/cdr/3832e508-fd01-
4c8f-99dc-2ab83e9fd53e"
},
"response": {
"code": "0",
"description": "El Resumen diario RC-20190126-5, ha sido aceptado",
"notes": []
}
}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

8. ANULACIÓN BOLETAS

8.1 REGISTRAR Y ENVIAR ANULACIÓN

Cuando se genera una anulación de boleta, esta no se envía inmediatamente a
Sunat. Este documento se envía mediante un resúmen, este puede contener 1 o
más boletas, para registrar y enviar el resúmen de anulación puede usar el
siguiente servicio, necesitará la url, el token, la fecha de emisión de las boletas que
conformarán el resumen, y la data de los documentos.

Cuando haya culminado este procedimiento, deberá consultar el ticket del

resumen de anulación generado, se explicará en el siguiente punto.

Url: http://demo.2facturaloperuonline.com/api/summaries
Token: ZRRxdDZ41gkGcHrnbxk4NZqTezbhDxXnddZfTqyy7zQNBm49rT

Ejemplo:

JSON A ENVIAR

{
"fecha_de_emision_de_documentos": "2019-01-20",
"codigo_tipo_proceso": "3",
"documentos": [
{
"external_id": "470cd665-c7bf-4b7d-9e0c-8631bf444c9c",
"motivo_anulacion": "Se duplicó documento"
}
]
}

JSON RESPUESTA

{
"success": true,
"data": {
"external_id": "8f6568f5-e478-4ae2-8d21-0b91c0112e57",
"ticket": "1548517805048"
}
}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

8.2 CONSULTAR TICKET ANULACIÓN

Para consultar el ticket del resumen de anulación generado puede usar el
siguiente servicio, necesitará la url, el token, el external_id (resumen) y el numero
de ticket.

Url: http://demo.2facturaloperuonline.com/api/summaries/status
Token: ZRRxdDZ41gkGcHrnbxk4NZqTezbhDxXnddZfTqyy7zQNBm49rT

Cuando haya culminado este procedimiento, el resumen de anulación con la

boletas que lo conforman han sido aceptadas exitosamente por Sunat, es decir el
(los) documento(s) han sido anulados.

Ejemplo:

JSON A ENVIAR

{
"external_id": "8f6568f5-e478-4ae2-8d21-0b91c0112e57",
"ticket": "1548517805048"
}

JSON RESPUESTA

{
"success": true,
"data": {
"filename": "20415963255-RC-20190126-6",
"external_id": "8f6568f5-e478-4ae2-8d21-0b91c0112e57"
},
"links": {
"xml":
"http://demo26.multifacturalonew.oo:8084/downloads/summary/xml/8f6568f5-e478-
4ae2-8d21-0b91c0112e57",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/summary/cdr/8f6568f5-e478-
4ae2-8d21-0b91c0112e57"
},
"response": {
"code": "0",
"description": "El Resumen diario RC-20190126-6, ha sido aceptado",
"notes": []
}
}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

9. ANULACIÓN FACTURAS - NOTAS

9.1 REGISTRAR Y ENVIAR ANULACIÓN

Cuando se genera una anulación de facturas o notas (generadas a partir de
facturas), esta no se envía inmediatamente a Sunat. Este documento se envía
mediante un grupo o de forma individual, para registrar y enviar la anulación,
puede usar el siguiente servicio, necesitará la url, el token, la fecha de emisión de
documentos que conformarán la anulación, y la data de los documentos.

Cuando haya culminada este procedimiento, deberá consultar el ticket de la

anulacion generada, se explicará en el siguiente punto.

Url: http://demo.2facturaloperuonline.com/api/voided
Token: ZRRxdDZ41gkGcHrnbxk4NZqTezbhDxXnddZfTqyy7zQNBm49rT

Ejemplo:

JSON A ENVIAR

{
"fecha_de_emision_de_documentos": "2019-01-26",
"documentos": [
{
"external_id": "c6057c05-6ec8-44d0-9fb9-23159498ce8e",
"motivo_anulacion": "Se duplicó documento"
}
]
}

JSON RESPUESTA

{
"success": true,
"data": {
"external_id": "0a1382c6-e639-46fc-a8ae-d4659b63c4bd",
"ticket": "1548518223324"
}
}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

9.2 CONSULTAR TICKET ANULACIÓN

Para consultar el ticket de la anulación generada puede usar el siguiente servicio,
necesitará la url, el token, el external_id (resumen) y el numero de ticket.

Url: http://demo.2facturaloperuonline.com/api/voided/status
Token: ZRRxdDZ41gkGcHrnbxk4NZqTezbhDxXnddZfTqyy7zQNBm49rT

Cuando haya culminado este procedimiento, la anulación con las facturas o notas
que lo conforman han sido aceptadas exitosamente por Sunat, es decir el (los)
documento(s) han sido anulados.

Ejemplo:

JSON A ENVIAR

{
"external_id": "8f6568f5-e478-4ae2-8d21-0b91c0112e57",
"ticket": "1548517805048"
}

JSON RESPUESTA

{
"success": true,
"data": {
"filename": "20415963255-RA-20190126-1",
"external_id": "0a1382c6-e639-46fc-a8ae-d4659b63c4bd"
},
"links": {
"xml": "http://demo26.multifacturalonew.oo:8084/downloads/voided/xml/0a1382c6-
e639-46fc-a8ae-d4659b63c4bd",
"cdr": "http://demo26.multifacturalonew.oo:8084/downloads/voided/cdr/0a1382c6-
e639-46fc-a8ae-d4659b63c4bd"
},
"response": {
"code": "0",
"description": "La Comunicación de baja RA-20190126-1, ha sido aceptada",
"notes": []
}
}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

10. GUÍA DE REMISIÓN

10.1 GENERAR GUIA DE REMISIÓN

Las Guías de Remisión son documentos que sustentan el traslado de bienes entre
distintas direcciones, existen distintas modalidades y aspectos relevantes.

Para generar una guia de remision puede usar el siguiente servicio, necesitará la
url, el token, y los datos del documento.

Url: http://demo.2facturaloperuonline.com/api/dispatches
Token: ZRRxdDZ41gkGcHrnbxk4NZqTezbhDxXnddZfTqyy7zQNBm49rT

Ejemplo:

JSON A ENVIAR

{
"serie_documento": "T001",
"numero_documento": "#",
"fecha_de_emision": "2018-10-09",
"hora_de_emision": "10:11:11",
"codigo_tipo_documento": "09",
"datos_del_emisor": {
"codigo_pais": "PE",
"ubigeo": "150101",
"direccion": "Av. 2 de Mayo",
"correo_electronico": "demo@gmail.com",
"telefono": "427-1148",
"codigo_del_domicilio_fiscal": "0000"
},
"datos_del_cliente_o_receptor":{
"codigo_tipo_documento_identidad": "6",
"numero_documento": "10414711225",
"apellidos_y_nombres_o_razon_social": "EMPRESA XYZ S.A.",
"nombre_comercial": "EMPRESA XYZ",
"codigo_pais": "PE",
"ubigeo": "150101",
"direccion": "Av. 2 de Mayo",
"correo_electronico": "demo@gmail.com",
"telefono": "427-1148"
},
"observaciones": "aaaaaaaaaaaaaaa",
"codigo_modo_transporte": "01",
"codigo_motivo_traslado": "01",
"descripcion_motivo_traslado": "El cliente solicito envia a su trabajo en ...",
"fecha_de_traslado": "2019-01-16",
"codigo_de_puerto": "",
"indicador_de_transbordo": false,
"unidad_peso_total": "KGM",
"peso_total": 30.00,

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

"numero_de_bultos": 1,
"numero_de_contenedor": "",
"direccion_partida": {
"ubigeo": "150101",
"direccion": "PUNTO A"
},
"direccion_llegada": {
"ubigeo": "150101",
"direccion": "PUNTO 2"
},
"transportista": {
"codigo_tipo_documento_identidad": "6",
"numero_documento": "10417844398",
"apellidos_y_nombres_o_razon_social": "aaaaaaaaa"
},
"chofer": {
"codigo_tipo_documento_identidad": "1",
"numero_documento": "4177874"
},
"numero_de_placa": "A01-1254",
"items":[
{
"codigo_interno": "P0121",
"cantidad": 2
}
]
}

JSON RESPUESTA

{
"success": true,
"data": {
"number": "T001-1",
"filename": "20415963255-09-T001-1",
"external_id": "89f6931f-9be0-4f92-80ad-8a7fbfce9160"
},
"links": {
"xml": "http://demo26.multifacturalonew.oo:8084/downloads/dispatch/xml/89f6931f-
9be0-4f92-80ad-8a7fbfce9160",
"pdf": "http://demo26.multifacturalonew.oo:8084/downloads/dispatch/pdf/89f6931f-
9be0-4f92-80ad-8a7fbfce9160",
"cdr": "http://demo26.multifacturalonew.oo:8084/downloads/dispatch/cdr/89f6931f-
9be0-4f92-80ad-8a7fbfce9160"
},
"response": {
"code": "0",
"description": "El Comprobante numero T001-1 ha sido aceptado",
"notes": []
}
}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

11. RETENCIÓN

11.1 GENERAR COMPROBANTE DE RETENCIÓN

Es una constancia de que alguna persona moral te retuvo algún tipo de impuesto,
(relativo al Impuesto Sobre la Renta), y sirve para demostrar que dicho impuesto
te fue retenido, y presentarlo a la autoridad fiscal en caso que te sea requerido.

Para generar un comprobante de retención puede usar el siguiente servicio,

necesitará la url, el token, y los datos del documento.

Url: http://demo.2facturaloperuonline.com/api/retentions
Token: ZRRxdDZ41gkGcHrnbxk4NZqTezbhDxXnddZfTqyy7zQNBm49rT

Ejemplo:

JSON A ENVIAR

{
"serie_documento": "R001",
"numero_documento": "#",
"fecha_de_emision": "2018-10-09",
"hora_de_emision": "10:11:11",
"codigo_tipo_documento": "20",
"datos_del_emisor": {
"codigo_pais": "PE",
"ubigeo": "150101",
"direccion": "Av. 2 de Mayo",
"correo_electronico": "demo@gmail.com",
"telefono": "427-1148",
"codigo_del_domicilio_fiscal": "0000"
},
"datos_del_proveedor":{
"codigo_tipo_documento_identidad": "6",
"numero_documento": "10414711225",
"apellidos_y_nombres_o_razon_social": "EMPRESA XYZ S.A.",
"nombre_comercial": "EMPRESA XYZ",
"codigo_pais": "PE",
"ubigeo": "150101",
"direccion": "Av. 2 de Mayo",
"correo_electronico": "demo@gmail.com",
"telefono": "427-1148"
},
"codigo_tipo_retencion": "01",
"observaciones": "-",
"totales": {
"total_retenido": 30.00,
"total_pagado": 1000.00
},
"documentos":[
{

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

"codigo_tipo_documento": "01",
"serie_documento": "F001",
"numero_documento": "3",
"fecha_de_emision": "2018-10-09",
"codigo_tipo_moneda": "PEN",
"pagos": [
{
"fecha_de_pago": "2018-10-09",
"total_pago": 200.00,
"codigo_tipo_moneda": "PEN"
}
],
"tipo_de_cambio": {
"codigo_tipo_moneda_referencia": "PEN",
"codigo_tipo_moneda_objetivo": "PEN",
"factor": 1,
"fecha_tipo_de_cambio": "2018-10-09"
},
"fecha_de_retencion": "2018-10-09",
"total_documento": 400.00,
"total_retenido": 12.00,
"total_a_pagar": 412.00,
"total_pagado": 412.00
},
{
"codigo_tipo_documento": "01",
"serie_documento": "F001",
"numero_documento": "4",
"fecha_de_emision": "2018-10-09",
"codigo_tipo_moneda": "USD",
"total_documento": 200.00,
"pagos": [
{
"fecha_de_pago": "2018-10-09",
"total_pago": 200.00,
"codigo_tipo_moneda": "USD"
}
],
"tipo_de_cambio": {
"codigo_tipo_moneda_referencia": "USD",
"codigo_tipo_moneda_objetivo": "PEN",
"factor": 3.00,
"fecha_tipo_de_cambio": "2018-10-09"
},
"fecha_de_retencion": "2018-10-09",
"total_retenido": 18.00,
"total_a_pagar": 618.00,
"total_pagado": 618.00
}
]
}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

JSON RESPUESTA

{
"success": true,
"data": {
"number": "R001-1",
"filename": "20415963255-20-R001-1",
"external_id": "3249264a-fa7a-4c02-a7ce-37e19186dba0"
},
"links": {
"xml":
"http://demo26.multifacturalonew.oo:8084/downloads/retention/xml/3249264a-fa7a-
4c02-a7ce-37e19186dba0",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/retention/pdf/3249264a-fa7a-
4c02-a7ce-37e19186dba0",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/retention/cdr/3249264a-fa7a-
4c02-a7ce-37e19186dba0"
},
"response": {
"code": "0",
"description": "El Comprobante numero R001-1 ha sido aceptado",
"notes": []
}
}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

12. OTRAS FUNCIONALIDADES

12.1 ENVIAR COMPROBANTE POR CORREO ELECTRÓNICO

Para enviar el comprobante mediante correo electronico necesita agregar el
siguiente objeto al json principal.

OBJETO

"acciones": {
"enviar_email":true
}

Tenga en cuenta que su cliente debe tener un correo valido para que el envio sea
satisfactorio. El correo a modificar se encuentra en el objeto
“datos_del_cliente_o_receptor” => “correo_electronico”.

Ejemplo:

JSON A ENVIAR

{
"serie_documento": "F001",
"numero_documento": "#",
"fecha_de_emision": "2018-10-09",
"hora_de_emision": "10:11:11",
"codigo_tipo_operacion": "0101",
"codigo_tipo_documento":"01",
"codigo_tipo_moneda": "PEN",
"fecha_de_vencimiento":"2018-08-30",
"numero_orden_de_compra": "0045467898",
"datos_del_cliente_o_receptor":{
"codigo_tipo_documento_identidad": "6",
"numero_documento": "10414711225",
"apellidos_y_nombres_o_razon_social": "EMPRESA XYZ S.A.",
"codigo_pais": "PE",
"ubigeo": "150101",
"direccion": "Av. 2 de Mayo",
"correo_electronico": "micorreo@gmail.com",
"telefono": "427-1148"
},
"totales": {
"total_exportacion": 0.00,
"total_operaciones_gravadas": 100.00,
"total_operaciones_inafectas": 0.00,
"total_operaciones_exoneradas": 0.00,
"total_operaciones_gratuitas": 0.00,
"total_igv": 18.00,
"total_impuestos": 18.00,
"total_valor": 100,

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

"total_venta": 118
},
"items":[
{
"codigo_interno": "P0121",
"descripcion":"Inca Kola 250 ml",
"codigo_producto_sunat": "51121703",
"unidad_de_medida": "NIU",
"cantidad": 2,
"valor_unitario": 50,
"codigo_tipo_precio": "01",
"precio_unitario": 59,
"codigo_tipo_afectacion_igv": "10",
"total_base_igv": 100.00,
"porcentaje_igv": 18,
"total_igv": 18,
"total_impuestos": 18,
"total_valor_item": 100,
"total_item": 118
}
],
"acciones": {
"enviar_email":true
}
}

12.2 CAMBIAR FORMATO DE REPRESENTACION IMPRESA

Para modificar el formato del comprobante necesita agregar el siguiente objeto al
json principal.

OBJETO

"acciones": {
"formato_pdf":"ticket"
}

Los formatos admitidos son a4 y ticket, para Facturas, Boletas y Notas, los demas
comprobantes solo cuentan con el formato a4. Tenga en cuenta que si no envia el
formato, por defecto sera a4.

Ejemplo:

JSON A ENVIAR

{
"serie_documento": "F001",
"numero_documento": "#",

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

"fecha_de_emision": "2018-10-09",
"hora_de_emision": "10:11:11",
"codigo_tipo_operacion": "0101",
"codigo_tipo_documento":"01",
"codigo_tipo_moneda": "PEN",
"fecha_de_vencimiento":"2018-08-30",
"numero_orden_de_compra": "0045467898",
"datos_del_cliente_o_receptor":{
"codigo_tipo_documento_identidad": "6",
"numero_documento": "10414711225",
"apellidos_y_nombres_o_razon_social": "EMPRESA XYZ S.A.",
"codigo_pais": "PE",
"ubigeo": "150101",
"direccion": "Av. 2 de Mayo",
"correo_electronico": "correo@gmail.com",
"telefono": "427-1148"
},
"totales": {
"total_exportacion": 0.00,
"total_operaciones_gravadas": 100.00,
"total_operaciones_inafectas": 0.00,
"total_operaciones_exoneradas": 0.00,
"total_operaciones_gratuitas": 0.00,
"total_igv": 18.00,
"total_impuestos": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{
"codigo_interno": "P0121",
"descripcion":"Inca Kola 250 ml",
"codigo_producto_sunat": "51121703",
"unidad_de_medida": "NIU",
"cantidad": 2,
"valor_unitario": 50,
"codigo_tipo_precio": "01",
"precio_unitario": 59,
"codigo_tipo_afectacion_igv": "10",
"total_base_igv": 100.00,
"porcentaje_igv": 18,
"total_igv": 18,
"total_impuestos": 18,
"total_valor_item": 100,
"total_item": 118
}
],
"acciones": {
"formato_pdf":"ticket"
}
}

Lima Perú 2019

 www.fastura.pe soporte@fastura.pe

Lima Perú 2019