DOCUMENTACIÓN API REST

DOCUMENTACIÓN API REST
2019
ÍNDICE
ÍNDICE
2
1. INTRODUCCIÓN
4
2. ACCESO
2.1 USO DE LA URL Y TOKEN
2.2 SUGERENCIAS
2.3 OPERACIONES
4
5
5
5
3. RESPUESTA API
6
4. GENERAR FACTURAS
4.1 FACTURA GRAVADA
4.2 FACTURA INAFECTA
4.3 FACTURA GRAVADA - GRATUITA
4.4 FACTURA GRAVADA EN DÓLARES
4.5 FACTURA GRATUITA
4.6 FACTURA EXONERADA
4.7 FACTURA GRAVADA SIN ENVIAR
4.8 ENVIAR FACTURA GENERADA OFFLINE
4.9 FACTURA - DATOS ADICIONALES - GUIAS
4.10 FACTURA - D. ADICIONALES - DOC. RELACIONADOS
4.11 FACTURA - D. ADICIONALES A NIVEL DE ITEM
4.12 FACTURA CONTINGENCIA
4.13 FACTURA GRAVADA - IMPUESTO BOLSA PLASTICA
7
7
9
11
13
15
17
19
21
22
24
26
28
29
5. GENERAR BOLETAS
5.1 BOLETA GRAVADA
5.2 BOLETA GRAVADA - CONTINGENCIA
31
31
33
6. GENERAR NOTAS
6.1 NOTA CRÉDITO - FACTURA
6.2 NOTA DÉBITO - FACTURA
35
35
37
7. GENERAR RESÚMENES
7.1 REGISTRAR Y ENVIAR RESÚMEN
7.2 CONSULTAR TICKET
38
38
40
8. ANULACIÓN BOLETAS
8.1 REGISTRAR Y ENVIAR ANULACIÓN
8.2 CONSULTAR TICKET ANULACIÓN
41
41
42
9. ANULACIÓN FACTURAS - NOTAS
9.1 REGISTRAR Y ENVIAR ANULACIÓN
43
43
9.2 CONSULTAR TICKET ANULACIÓN
44
10. GUÍA DE REMISIÓN
10.1 GENERAR GUIA DE REMISIÓN
45
45
11. RETENCIÓN
11.1 GENERAR COMPROBANTE DE RETENCIÓN
47
47
12. OTRAS FUNCIONALIDADES
12.1 ENVIAR COMPROBANTE POR CORREO ELECTRÓNICO
12.2 CAMBIAR FORMATO DE REPRESENTACION IMPRESA
50
50
51
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.
La api 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.facturalo.pro/api/documents
TOKEN: oZoKGFDzqGJfJilCHowJlZrTadQRBtuJ2fr3PkJz02aU46WPPg
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 oZoKGFDzqGJfJilCHowJlZrTadQRBtuJ2fr3PkJz02aU46WPPg
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.
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-893ca
5f94677", => Enlace de descarga del XML firmado
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/document/pdf/7eff377b-de6c-4af3-ba6a-893ca
5f94677", => Enlace de descarga del PDF
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/document/cdr/7eff377b-de6c-4af3-ba6a-893ca
5f94677" => Enlace de descarga del CDR
},
"response": {
"code": "0",
"description": "La Factura número F001-4, ha sido aceptada", => Respuesta Sunat
"notes": []
}
}
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": "[email protected]",
"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
}
],
"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+a1AAAACXBIWXMAAA7EAAAOxAG
VKw4bAAAEgklEQVR4nO2d3XYbMQgG4568/yund45bqwQBWneOZy7t1U/yHZAWIXz7+vr6EDK/
Xj0B6aKEeJQQjxLiUUI8SohHCfEoIR4lxKOEeJQQjxLi+Uw+d7vd+oM9htTvHd4/fBzi+="
},
"links": {
"xml":
"http://demo26.multifacturalonew.oo:8084/downloads/document/xml/103c8710-6c6e-4b7b-8d7b-c5
9f642c7a71",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/document/pdf/103c8710-6c6e-4b7b-8d7b-c59
f642c7a71",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/document/cdr/103c8710-6c6e-4b7b-8d7b-c59
f642c7a71"
},
"response": {
"code": "0",
"description": "La Factura numero F001-5, ha sido aceptada",
"notes": []
}
}
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": "[email protected]",
"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": "",
"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,
"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-231
59498ce8e",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/document/pdf/c6057c05-6ec8-44d0-9fb9-231
59498ce8e",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/document/cdr/c6057c05-6ec8-44d0-9fb9-231
59498ce8e"
},
"response": {
"code": "0",
"description": "La Factura numero F001-7, ha sido aceptada",
"notes": []
}
}
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": "[email protected]",
"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": "",
"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
},
{
"codigo_interno": "P0122",
"descripcion":"Pepsi 250 ml",
"codigo_producto_sunat": "",
"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-6b0
1e3d3621b",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/document/pdf/9877a32d-b285-4f4a-9a8f-6b0
1e3d3621b",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/document/cdr/9877a32d-b285-4f4a-9a8f-6b0
1e3d3621b"
},
"response": {
"code": "0",
"description": "La Factura numero F001-8, ha sido aceptada",
"notes": [] }}
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": "[email protected]",
"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": "",
"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": "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+2vq4Soj2pyzXPX99qTEFmRviNIG
A8SxrO9qbB17NhU1E9urOlvPp0u4Mj3jUDCeMxXRGuWFV6WXUzq/p6/1Z3SrotuRPC9/vYDK/wP
QMJ47rgiOnF3N1TnrburnX89qroL6s7AF0gYDxLGM8qdsdS1FafARlK9XoxGHFWNNxmH6MwbgY
Tx3JGEuGSSSHjDwWzjQHj3JizlEuALJIznZY70YOKyJk++oQhXI0WxAVYYDxLGg4TxjOZCizdvnIs
eWK44Ne4ti+j186k789YgYTzbjvTmOriNLccN5RLELhoXEBptscJ4kDCel2VzgwusMB4kjAcJ40HCe
JAwHiSMBwnjQcJ4kDAeJIwHCeNBwniQMJ4/+yPKFTSawdUAAAAASUVORK5CYII="
},
"links": {
"xml":
"http://demo26.multifacturalonew.oo:8084/downloads/document/xml/085582cc-953c-4609-8078-d6
82ef17a19d",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/document/pdf/085582cc-953c-4609-8078-d68
2ef17a19d",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/document/cdr/085582cc-953c-4609-8078-d68
2ef17a19d"
},
"response": {
"code": "0",
"description": "La Factura numero F001-9, ha sido aceptada",
"notes": []
}
}
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": "[email protected]",
"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": "",
"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
}
],
"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+03ZiptPmikCVZoDxLac
1s2N0yBFdqDhPYgoT1IaA8S2oOE9iChPUhoDxLag4T2IKE9SGgPEtrzDwHhDzxi9N5VAAAAAElF
TkSuQmCC"
},
"links": {
"xml":
"http://demo26.multifacturalonew.oo:8084/downloads/document/xml/7777062c-a22a-4d2c-925e-94
063f3d4596",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/document/pdf/7777062c-a22a-4d2c-925e-94
063f3d4596",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/document/cdr/7777062c-a22a-4d2c-925e-94
063f3d4596"
},
"response": {
"code": "0",
"description": "La Factura numero F001-14, ha sido aceptada",
"notes": []
}
}
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": "[email protected]",
"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": 118.00,
"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+a1AAAACXBIWXMAAA7EAAAOxAG
VKw4bAAAEZElEQVR4nO2dwW7jMAxEk0X//5e7l0UQ1FyV4oydDPLesbElJQNSEkWx9+/v7xsk8+
fVAwAVJIwHCeNBwniQMB4kjAcJ40HCeJAwHiS7vSJtRPEsaDhPEgYTxIGM9fuiMPDwbdPS0AAA
AASUVORK5CYII="
},
"links": {
"xml":
"http://demo26.multifacturalonew.oo:8084/downloads/document/xml/5a3b1a7e-2c71-4d20-b808-50
ea0a82d6d2",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/document/pdf/5a3b1a7e-2c71-4d20-b808-50
ea0a82d6d2",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/document/cdr/5a3b1a7e-2c71-4d20-b808-50
ea0a82d6d2"
},
"response": {
"code": "0",
"description": "La Factura numero F001-17, ha sido aceptada",
"notes": []
}
}
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": "[email protected]",
"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": {
"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+a1AAAACXBIWXMAAA7EAAAOxAG
VKw4bAAAEbUlEQVR4nO2d227jMAxEm8X+/y9334IAVhmKM3Y663MeE+vSDEhZFMU+vr+/vyCZ
P5+eAKggYTxIGA8SxoOE8SBhPEgYDxLGg4TxIGE8SBgPEsbzt/nc4/HQB3sNqR87HATcl7M69m
OZ/LLnJfbfqgYrjAcJ4+k60ifnubsBzU76Y7lc7u64ygSwwniQMB4kjGd7LXyldtz1SvBsu3ysuSQMhjh+
+DrW7oakbtvvR3kzwArjQcJ4JEdqofaotZtteqfa3aWnYWKF8SBhPJ93pE/6gQklkL37Rlp78t/ghLHC
eJAwHiSMR1oLlZXguBT1byNQfCWGE8SBiPFObe9Z/9yI5y5Fuz28Se/9JcVghz3wgkjEeKzjTvoVtc
1uDbQargbrx+cD7qDQ99YYX/AUgYDxLGY95U2E9K7YnxSoTl2IlyM9kFVhgPEsYjbSpqmkHwerhj
b8sOXSn3nZksO+nPyn6JA="
},
"links": {
"xml":
"http://demo26.multifacturalonew.oo:8084/downloads/document/xml/7d9feb66-16e9-47a9-86fd-ebc
cdb662678",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/document/pdf/7d9feb66-16e9-47a9-86fd-ebc
cdb662678",
"cdr": ""
},
"response": []
}
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.facturalo.pro/api/documents/send
Token: oZoKGFDzqGJfJilCHowJlZrTadQRBtuJ2fr3PkJz02aU46WPPg
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-ebc
cdb662678"
},
"response": {
"code": "0",
"description": "La Factura numero F001-15, ha sido aceptada",
"notes": []
}
}
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": "[email protected]",
"telefono": "427-1148"
},
"guias":[
{
"numero": "T001",
"codigo_tipo_documento": "09"
},
{
"numero": "T002",
"codigo_tipo_documento": "09"
}
],
"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"
}
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": "[email protected]",
"telefono": "427-1148"
},
"relacionados":[
{
"numero": "12",
"codigo_tipo_documento": "01",
"monto": 150.00
},
{
"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"
}
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": "[email protected]",
"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,
"datos_adicionales":[
{
"codigo": "5010",
"descripcion": "Numero de Placa",
"valor": "A7Q-986"
}
]
}
],
"informacion_adicional": "Forma de pago:Efectivo|Caja: 1"
}
4.12 FACTURA CONTINGENCIA
Para generar una factura de contingencia previamente debe registrar las series de
contingencia, en el módulo Usuarios/Locales & Series sección Establecimientos.
Ejemplo:
JSON A ENVIAR
{
"serie_documento": "0001",
"numero_documento": "#",
"fecha_de_emision": "2019-09-03",
"hora_de_emision": "10:11:11",
"fecha_de_vencimiento":"2019-09-03",
"codigo_tipo_operacion": "0101",
"codigo_tipo_documento":"01",
"codigo_tipo_moneda": "PEN",
"datos_del_cliente_o_receptor":{
"codigo_tipo_documento_identidad": "6",
"numero_documento": "20501973522",
"apellidos_y_nombres_o_razon_social": "EMBOTELLADORA DON JORGE S.A.C. EN
LIQUIDACION",
"codigo_pais": "PE",
"ubigeo": "150101",
"direccion": "Av. Argentina 2458",
"correo_electronico": "[email protected]",
"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
}
],
"informacion_adicional": "Forma de pago:Efectivo|Caja: 1"
}
4.13 FACTURA GRAVADA - IMPUESTO BOLSA PLASTICA
Ejemplo:
JSON A ENVIAR
{
"serie_documento": "F001",
"numero_documento": "#",
"fecha_de_emision": "2019-09-03",
"hora_de_emision": "10:11:11",
"codigo_tipo_operacion": "0101",
"codigo_tipo_documento":"01",
"codigo_tipo_moneda": "PEN",
"fecha_de_vencimiento":"2019-09-03",
"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": "[email protected]",
"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_impuestos_bolsa_plastica": 0.2,
"total_igv": 18.00,
"total_impuestos": 18.00,
"total_valor": 100,
"total_venta": 118.2
},
"items":[
{
"codigo_interno": "P0015",
"descripcion":"Pepsi 3 lt",
"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_bolsa_plastica": 0.2,
"total_impuestos": 18,
"total_valor_item": 100,
"total_item": 118
}
],
"informacion_adicional": "Forma de pago:Efectivo|Caja: 1"
}
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": "[email protected]",
"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
}
]
}
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+a1AAAACXBIWXMAAA7EAAAOxAG
VKw4bAAAEaUlEQVR4nO2d23LbMAwF607//5fTt9QTswhIHMvZ8e5jJYtszwCicOvt4+Pjl5D5/eoNy
BQlxKOEeJQQjxLiUUI8SohHCfEoIR4lxKOEeJQQzdfVqdTI7308Zf+c3lLMh/R5QQz8iRTpgElCdRkt
3ez4MRD5Hb+miFeJQQz8sc6SOTmuvUeK8sk4bZPlohHiXEo4R4MsMs40wiO3X/0e5akx7gVFdUj
VaIRwnxPHGAV+SBF5TNHzi0ZmgplWqu0QrxKCGel1VzSwqtEI8S4lFCPEqIRwnxKCEeJcSjhHiUE
I8S4lFCPEqIRwnx/AV6e7I2Yyb8aQAAAABJRU5ErkJggg=="
},
"links": {
"xml":
"http://demo26.multifacturalonew.oo:8084/downloads/document/xml/346135d8-b730-48e2-81f4-d0
0c9690f4ca",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/document/pdf/346135d8-b730-48e2-81f4-d00
c9690f4ca",
"cdr": ""
},
"response": []
}
5.2 BOLETA GRAVADA - CONTINGENCIA
Para generar una factura de contingencia previamente debe registrar las series de
contingencia, en el módulo Usuarios/Locales & Series sección Establecimientos.
Ejemplo:
JSON A ENVIAR
{
"serie_documento": "0004",
"numero_documento": "#",
"fecha_de_emision": "2019-09-03",
"hora_de_emision": "10:11:11",
"codigo_tipo_operacion": "0101",
"codigo_tipo_documento":"03",
"codigo_tipo_moneda": "PEN",
"fecha_de_vencimiento": "2019-09-03",
"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": "[email protected]",
"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
}
]
}
JSON RESPUESTA
{
"success": true,
"data": {
"number": "0004-1",
"filename": "20415963255-03-0004-1",
"external_id": "346135d8-b730-48e2-81f4-d00c9690f4ca",
"number_to_letter": "Ciento dieciocho con 00/100 ",
"hash": "T3/grz45f3rK5xz7/PtlrNuhlCo=",
"qr":
"iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAIAAACzY+a1AAAACXBIWXMAAA7EAAAOxAG
VKw4bAAAEaUlEQVR4nO2d23LbMAwF607//5fTt9QTswhIHMvZ8e5jJYtszwCicOvt4+Pjl5D5/eoNy
BQlxKOEeJQQjxLiUUI8SohHCfEoIR4lxKOEeJQQzdfVqdTI7308Zf+c3lLMh/R5QQz8iRTpgElCdRkt
3ez4MRD5Hb+miFeJQQz8sc6SOTmuvUeK8sk4bZPlohHiXEo4R4MsMs40wiO3X/0e5akx7gVFdUj
VaIRwnxPHGAV+SBF5TNHzi0ZmgplWqu0QrxKCGel1VzSwqtEI8S4lFCPEqIRwnxKCEeJcSjhHiUE
I8S4lFCPEqIRwnx/AV6e7I2Yyb8aQAAAABJRU5ErkJggg=="
},
"links": {
"xml":
"http://demo26.multifacturalonew.oo:8084/downloads/document/xml/346135d8-b730-48e2-81f4-d0
0c9690f4ca",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/document/pdf/346135d8-b730-48e2-81f4-d00
c9690f4ca",
"cdr": ""
},
"response": []
}
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": "[email protected]",
"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": "",
"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/JJnghWGE8SBgPEsaDhPEgYTxIG
A8SxoOE8SBhPEgYDxLGg4TxIGE8fwFHMbVs99tbGwAAAABJRU5ErkJggg=="
},
"links": {
"xml":
"http://demo26.multifacturalonew.oo:8084/downloads/document/xml/92f5a566-512d-4159-b4c6-b60
00e697328",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/document/pdf/92f5a566-512d-4159-b4c6-b60
00e697328",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/document/cdr/92f5a566-512d-4159-b4c6-b60
00e697328"
},
"response": {
"code": "0",
"description": "La Nota de Crédito numero FC01-1, ha sido aceptada",
"notes": []
}}
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": "[email protected]",
"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
}
]
}
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+a1AAAACXBIWXMAAA7EAAAOxAG
VKw4bAAAEi0lEQVR4nO2d227jMAxEm0X//5U0RfcaBOzu4GLC9Af2BiLFcaDhPFcls0NLrDCeJAw
HiSMBwnjQcJ4kDAeJIwHCeNBwniQMB4kjAcJ40HCeP4CPz+yVDvGghIAAAAASUVORK5CYII="
},
"links": {
"xml":
"http://demo26.multifacturalonew.oo:8084/downloads/document/xml/72a16a9d-382a-4ca4-a1ba-fad
fbd68f2fa",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/document/pdf/72a16a9d-382a-4ca4-a1ba-fad
fbd68f2fa",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/document/cdr/72a16a9d-382a-4ca4-a1ba-fad
fbd68f2fa"
},
"response": {
"code": "0",
"description": "La Nota de Débito numero FD01-1, ha sido aceptada",
"notes": []
}
}
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.facturalo.pro/api/summaries
Token: oZoKGFDzqGJfJilCHowJlZrTadQRBtuJ2fr3PkJz02aU46WPPg
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"
}
}
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.facturalo.pro/api/summaries/status
Token: oZoKGFDzqGJfJilCHowJlZrTadQRBtuJ2fr3PkJz02aU46WPPg
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-2ab8
3e9fd53e",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/summary/cdr/3832e508-fd01-4c8f-99dc-2ab8
3e9fd53e"
},
"response": {
"code": "0",
"description": "El Resumen diario RC-20190126-5, ha sido aceptado",
"notes": []
}
}
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.facturalo.pro/api/summaries
Token: oZoKGFDzqGJfJilCHowJlZrTadQRBtuJ2fr3PkJz02aU46WPPg
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"
}
}
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.facturalo.pro/api/summaries/status
Token: oZoKGFDzqGJfJilCHowJlZrTadQRBtuJ2fr3PkJz02aU46WPPg
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-0b9
1c0112e57",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/summary/cdr/8f6568f5-e478-4ae2-8d21-0b91
c0112e57"
},
"response": {
"code": "0",
"description": "El Resumen diario RC-20190126-6, ha sido aceptado",
"notes": []
}
}
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 culminado este procedimiento, deberá consultar el ticket de la
anulación generada, se explicará en el siguiente punto.
Url: http://demo.facturalo.pro/api/voided
Token: oZoKGFDzqGJfJilCHowJlZrTadQRBtuJ2fr3PkJz02aU46WPPg
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"
}
}
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.facturalo.pro/api/voided/status
Token: oZoKGFDzqGJfJilCHowJlZrTadQRBtuJ2fr3PkJz02aU46WPPg
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-d4659
b63c4bd",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/voided/cdr/0a1382c6-e639-46fc-a8ae-d4659b
63c4bd"
},
"response": {
"code": "0",
"description": "La Comunicación de baja RA-20190126-1, ha sido aceptada",
"notes": []
}
}
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.facturalo.pro/api/dispatches
Token: oZoKGFDzqGJfJilCHowJlZrTadQRBtuJ2fr3PkJz02aU46WPPg
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": "[email protected]",
"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": "[email protected]",
"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,
"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-8a7fbf
ce9160",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/dispatch/pdf/89f6931f-9be0-4f92-80ad-8a7fbf
ce9160",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/dispatch/cdr/89f6931f-9be0-4f92-80ad-8a7fbf
ce9160"
},
"response": {
"code": "0",
"description": "El Comprobante numero T001-1 ha sido aceptado",
"notes": []
}
}
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.facturalo.pro/api/retentions
Token: oZoKGFDzqGJfJilCHowJlZrTadQRBtuJ2fr3PkJz02aU46WPPg
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": "[email protected]",
"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": "[email protected]",
"telefono": "427-1148"
},
"codigo_tipo_retencion": "01",
"observaciones": "-",
"totales": {
"total_retenido": 30.00,
"total_pagado": 1000.00
},
"documentos":[
{
"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
}
]
}
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-37e1
9186dba0",
"pdf":
"http://demo26.multifacturalonew.oo:8084/downloads/retention/pdf/3249264a-fa7a-4c02-a7ce-37e1
9186dba0",
"cdr":
"http://demo26.multifacturalonew.oo:8084/downloads/retention/cdr/3249264a-fa7a-4c02-a7ce-37e1
9186dba0"
},
"response": {
"code": "0",
"description": "El Comprobante numero R001-1 ha sido aceptado",
"notes": []
}
}
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": "[email protected]",
"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": {
"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": "#",
"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": "[email protected]",
"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"
}
}
13. PRODUCTOS
13.1 REGISTRAR PRODUCTOS
Para registrar productos debe enviar hacia
Url: http://demo.facturalo.pro/api/item
Ejemplo:
JSON A ENVIAR
{
"item_type_id": "01",
"internal_id": "123456",
"item_code": null,
"item_code_gs1": null,
"description": "el nombre",
"name": "la descripción",
"second_name": null,
"unit_type_id": "NIU",
"currency_type_id": "PEN",
"sale_unit_price": "5",
"purchase_unit_price": 0,
"has_isc": false,
"system_isc_type_id": null,
"percentage_isc": 0,
"suggested_price": 0,
"sale_affectation_igv_type_id": "10",
"purchase_affectation_igv_type_id": "10",
"calculate_quantity": false,
"stock": 0,
"stock_min": 0,
"has_igv": true,
"has_perception": false,
"item_unit_types": [],
"percentage_of_profit": 0,
"percentage_perception": 0,
"is_set": false,
"account_id": null,
"category_id": null,
"brand_id": null,
"date_of_due": null,
"lot_code": null,
"lots_enabled": false,
"lots": []
}
JSON RESPUESTA
{
"success": true,
"msg": "Producto registrado con éxito",
"data": {
"id": 2,
"item_id": 2,
"name": "la descripción",
"full_description": "123456 - el nombre",
"description": "el nombre",
"currency_type_id": "PEN",
"internal_id": "123456",
"item_code": null,
"currency_type_symbol": "S/",
"sale_unit_price": "5.00",
"purchase_unit_price": 0,
"unit_type_id": "NIU",
"sale_affectation_igv_type_id": "10",
"purchase_affectation_igv_type_id": "10",
"calculate_quantity": false,
"has_igv": true,
"is_set": false,
"aux_quantity": 1
}
}
13.2 LISTAR PRODUCTOS
Para listar productos debe enviar por método get
Url: http://demo.facturalo.pro/api/document/search-items
JSON RESPUESTA
{
"success": true,
"data": {
"items": [
{
"id": 3908,
"item_id": 3908,
"name": null,
"full_description": "1006 - CHEESE TRIS X 16 Grs",
"description": "CHEESE TRIS X 16 Grs",
"currency_type_id": "PEN",
"internal_id": "1006",
"item_code": null,
"currency_type_symbol": "S/",
"sale_unit_price": "0.42",
"purchase_unit_price": "0.000000",
"unit_type_id": "NIU",
"sale_affectation_igv_type_id": "10",
"purchase_affectation_igv_type_id": "10",
"calculate_quantity": false,
"has_igv": true,
"is_set": false,
"aux_quantity": 1,
"brand": "",
"category": "",
"stock": -12,
"image": "https://demo.facturalo.pro/logo/imagen-no-disponible.jpg",
"warehouses": [
{
"warehouse_description": "Almacén Oficina Principal",
"stock": "7995.0000",
"warehouse_id": 1
},
{
"warehouse_description": "Almacén - Oficina Arequipa",
"stock": "-12.0000",
"warehouse_id": 4
}
]
},
{
"id": 3912,
"item_id": 3912,
"name": null,
"full_description": "2003 - DORITOS X 40 Grs",
"description": "DORITOS X 40 Grs",
"currency_type_id": "PEN",
"internal_id": "2003",
"item_code": null,
"currency_type_symbol": "S/",
"sale_unit_price": "1.00",
"purchase_unit_price": "0.000000",
"unit_type_id": "NIU",
"sale_affectation_igv_type_id": "10",
"purchase_affectation_igv_type_id": "10",
"calculate_quantity": false,
"has_igv": true,
"is_set": false,
"aux_quantity": 1,
"brand": "",
"category": "",
"stock": -6,
"image": "https://demo.facturalo.pro/logo/imagen-no-disponible.jpg",
"warehouses": [
{
"warehouse_description": "Almacén Oficina Principal",
"stock": "3060.0000",
"warehouse_id": 1
},
{
"warehouse_description": "Almacén - Oficina Arequipa",
"stock": "-6.0000",
"warehouse_id": 4
}
]
}
]
}
}
13.2 BUSCAR PRODUCTOS
Para buscar productos debe enviar por método get
Url: http://demo.facturalo.pro/api/document/search-items?input=cod_interno_o_descripcion
JSON RESPUESTA
{
"success": true,
"data": {
"items": [
{
"id": 3946,
"item_id": 3946,
"name": "apk",
"full_description": "rrr - apk",
"description": "apk",
"currency_type_id": "PEN",
"internal_id": "rrr",
"item_code": null,
"currency_type_symbol": "S/",
"sale_unit_price": "500.00",
"purchase_unit_price": "0.000000",
"unit_type_id": "NIU",
"sale_affectation_igv_type_id": "10",
"purchase_affectation_igv_type_id": "10",
"calculate_quantity": false,
"has_igv": true,
"is_set": false,
"aux_quantity": 1,
"brand": "",
"category": "",
"stock": 0,
"image": "https://demo.facturalo.pro/logo/imagen-no-disponible.jpg",
"warehouses": [
{
"warehouse_description": "Almacén - Oficina Arequipa",
"stock": "0.0000",
"warehouse_id": 4
}
]
}
]
}
}
13.3 EDIAR PRODUCTOS
Para editar productos debe enviar a
Url: http://demo.facturalo.pro/api/items/[id_del_producto]/update
JSON A ENVIAR
{
"id": 3946,
"item_type_id": "01",
"internal_id": "rrr",
"item_code": "new_code",
"item_code_gs1": null,
"description": "apk",
"name": "apk",
"second_name": null,
"unit_type_id": "NIU",
"currency_type_id": "PEN",
"sale_unit_price": "500",
"purchase_unit_price": 0,
"has_isc": false,
"system_isc_type_id": null,
"percentage_isc": 0,
"suggested_price": 0,
"sale_affectation_igv_type_id": "10",
"purchase_affectation_igv_type_id": "10",
"calculate_quantity": false,
"stock": 0,
"stock_min": 0,
"has_igv": true,
"has_perception": false,
"item_unit_types": [],
"percentage_of_profit": 0,
"percentage_perception": 0,
"image": null,
"image_url": null,
"temp_path": null,
"is_set": false,
"account_id": null,
"category_id": null,
"brand_id": null,
"date_of_due": null,
"lot_code": null,
"lots_enabled": false,
"lots": []
}
JSON RESPUESTA
{
"success": true,
"msg": "Producto editado con éxito",
"data": {
"id": 3946,
"item_id": 3946,
"name": "apk",
"full_description": "rrr - apk",
"description": "apk",
"currency_type_id": "PEN",
"internal_id": "rrr",
"item_code": "new_code",
"currency_type_symbol": "S/",
"sale_unit_price": "500.00",
"purchase_unit_price": "0.000000",
"unit_type_id": "NIU",
"sale_affectation_igv_type_id": "10",
"purchase_affectation_igv_type_id": "10",
"calculate_quantity": false,
"has_igv": true,
"is_set": false,
"aux_quantity": 1
}
}