Documentación API Rest

DOCUMENTACIÓN API REST
2021
ÍNDICE
ÍNDICE 2
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
4.12 FACTURA CONTINGENCIA 28
4.13 FACTURA GRAVADA - IMPUESTO BOLSA PLASTICA 29
5. GENERAR BOLETAS 31
5.1 BOLETA GRAVADA 31
5.2 BOLETA GRAVADA - CONTINGENCIA 33
6. GENERAR NOTAS 35
6.1 NOTA CRÉDITO - FACTURA 35
6.2 NOTA DÉBITO - FACTURA 37
7. GENERAR RESÚMENES 38
7.1 REGISTRAR Y ENVIAR RESÚMEN 38
7.2 CONSULTAR TICKET 40
8. ANULACIÓN BOLETAS 41
8.1 REGISTRAR Y ENVIAR ANULACIÓN 41
8.2 CONSULTAR TICKET ANULACIÓN 42
9. ANULACIÓN FACTURAS - NOTAS 43

9.1 REGISTRAR Y ENVIAR ANULACIÓN 43
9.2 CONSULTAR TICKET ANULACIÓN 44
10. GUÍA DE REMISIÓN 45

10.1 GENERAR GUIA DE REMISIÓN 45
11. RETENCIÓN 47
11.1 GENERAR COMPROBANTE DE RETENCIÓN 47
12. OTRAS FUNCIONALIDADES 50

12.1 ENVIAR COMPROBANTE POR CORREO ELECTRÓNICO 50
12.2 CAMBIAR FORMATO DE REPRESENTACION IMPRESA 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.facturaperu.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.multifacturaperunew.oo:8084/downloads/document/xml/7eff377b-de6c-4af3-
ba6a-893ca5f94677", => Enlace de descarga del XML firmado
"pdf": "http://demo26.multifacturaperunew.oo:8084/downloads/document/pdf/7eff377b-de6c-4af3-
ba6a-893ca5f94677", => Enlace de descarga del PDF
"cdr": "http://demo26.multifacturaperunew.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": []
}
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,
"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/X
j0B6aKEeJQQjxLiUUI8SohHCfEoIR4lxKOEeJQQjxLi+Uw+d7vd+oM9htTvHd4/fBzi+="
},
"links": {
"xml": "http://demo26.multifacturaperunew.oo:8084/downloads/document/xml/103c8710-6c6e-
4b7b-8d7b-c59f642c7a71",
"pdf": "http://demo26.multifacturaperunew.oo:8084/downloads/document/pdf/103c8710-6c6e-
4b7b-8d7b-c59f642c7a71",
"cdr": "http://demo26.multifacturaperunew.oo:8084/downloads/document/cdr/103c8710-6c6e-
4b7b-8d7b-c59f642c7a71"
},
"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
{
"ubigeo": "150101",
"telefono": "427-1148"
},
"totales": {
"total_igv": 0.00,
"total_valor": 118,
"total_venta": 118
},
"items":[
{
"codigo_producto_sunat": "",
"cantidad": 2,
"total_igv": 0.00,
"total_item": 118
}
]
}
JSON RESPUESTA
{
"success": true,
"data": {
"number": "F001-7",
"filename": "20415963255-01-F001-7",
"external_id": "c6057c05-6ec8-44d0-9fb9-23159498ce8e",
"hash": "wE4GOpgMM/ckUGdA7Qv2UzJYe70=",
"qr": "iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAIAAACwzDwIJ7bkt"
},
"links": {
"xml": "http://demo26.multifacturaperunew.oo:8084/downloads/document/xml/c6057c05-6ec8-
44d0-9fb9-23159498ce8e",
"pdf": "http://demo26.multifacturaperunew.oo:8084/downloads/document/pdf/c6057c05-6ec8-
44d0-9fb9-23159498ce8e",
"cdr": "http://demo26.multifacturaperunew.oo:8084/downloads/document/cdr/c6057c05-6ec8-
44d0-9fb9-23159498ce8e"
},
"response": {
"code": "0",
"notes": []
}
}
4.3 FACTURA GRAVADA - GRATUITA
Generar una factura con item gravado y gratuito.
Ejemplo:
JSON A ENVIAR
{
"fecha_de_vencimiento": "2018-10-09",
"ubigeo": "150101",
"telefono": "427-1148"
},
"totales": {
"total_igv": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{
"cantidad": 2,
"total_igv": 18,
"total_item": 118
},
{
"descripcion":"Pepsi 250 ml",
"cantidad": 2,
"valor_unitario": 0.00,
"precio_unitario": 0.00,
"porcentaje_igv": 18.00,
"total_igv": 18.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",
"hash": "P4wuH5ZRD5itfP903wo1V9jwuLw=",
"qr": "iVBORw0KGgoAAAANSUhEUgAAAJYAAACWCAIAAAC="
},
"links": {
"xml": "http://demo26.multifacturaperunew.oo:8084/downloads/document/xml/9877a32d-b285-
4f4a-9a8f-6b01e3d3621b",
"pdf": "http://demo26.multifacturaperunew.oo:8084/downloads/document/pdf/9877a32d-b285-
4f4a-9a8f-6b01e3d3621b",
"cdr": "http://demo26.multifacturaperunew.oo:8084/downloads/document/cdr/9877a32d-b285-
4f4a-9a8f-6b01e3d3621b"
},
"response": {
"code": "0",
"notes": [] }}
4.4 FACTURA GRAVADA EN DÓLARES
Ejemplo:
JSON A ENVIAR
{
"codigo_tipo_moneda": "USD",
"ubigeo": "150101",
"telefono": "427-1148"
},
"totales": {
"total_igv": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{
"cantidad": 2,
"total_igv": 18,
"total_item": 118
}
]
}
JSON RESPUESTA
{
"success": true,
"data": {
"number": "F001-9",
"filename": "20415963255-01-F001-9",
"external_id": "085582cc-953c-4609-8078-d682ef17a19d",
"hash": "wvkARde8TKhPpxDjVfEXTAPciiM=",
"qr":
"iVBORw0KGgoAAAANSUhEUgAAD6vetJt+ef8amAr5AwnjMd+2vq4Soj2pyzXPX99qTEFmRviNIG
A8SxrO9qbB17NhU1E9urOlvPp0u4Mj3jUDCeMxXRGuWFV6WXUzq/p6/1Z3SrotuRPC9/vYDK/wP
QMJ47rgiOnF3N1TnrburnX89qroL6s7AF0gYDxLGM8qdsdS1FafARlK9XoxGHFWNNxmH6MwbgY
Tx3JGEuGSSSHjDwWzjQHj3JizlEuALJIznZY70YOKyJk+
+oQhXI0WxAVYYDxLGg4TxjOZCizdvnIseWK44Ne4ti+j186k789YgYTzbjvTmOriNLccN5RLELhoXE
BptscJ4kDCel2VzgwusMB4kjAcJ40HCeJAwHiSMBwnjQcJ4kDAeJIwHCeNBwniQMJ4/+yPKFTSaw
dUAAAAASUVORK5CYII="
},
"links": {
"xml": "http://demo26.multifacturaperunew.oo:8084/downloads/document/xml/085582cc-953c-
4609-8078-d682ef17a19d",
"pdf": "http://demo26.multifacturaperunew.oo:8084/downloads/document/pdf/085582cc-953c-
4609-8078-d682ef17a19d",
"cdr": "http://demo26.multifacturaperunew.oo:8084/downloads/document/cdr/085582cc-953c-
4609-8078-d682ef17a19d"
},
"response": {
"code": "0",
"notes": []
}
}
4.5 FACTURA GRATUITA
Ejemplo:
JSON A ENVIAR
{
"ubigeo": "150101",
"telefono": "427-1148"
},
"totales": {
"total_igv": 0.00,
"total_valor": 0.00,
"total_venta": 0.00
},
"items":[
{
"cantidad": 2,
"valor_unitario": 0.00,
"precio_unitario": 0.00,
"porcentaje_igv": 18.00,
"total_igv": 18.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.multifacturaperunew.oo:8084/downloads/document/xml/7777062c-a22a-
4d2c-925e-94063f3d4596",
"pdf": "http://demo26.multifacturaperunew.oo:8084/downloads/document/pdf/7777062c-a22a-
4d2c-925e-94063f3d4596",
"cdr": "http://demo26.multifacturaperunew.oo:8084/downloads/document/cdr/7777062c-a22a-
4d2c-925e-94063f3d4596"
},
"response": {
"code": "0",
"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
{
"ubigeo": "150101",
"telefono": "427-1148"
},
"totales": {
"total_igv": 0.00,
"total_valor": 118,
"total_venta": 118
},
"items":[
{
"codigo_producto_gsl": "",
"cantidad": 2,
"total_igv": 0.00,
"total_item": 118
}
]
}
JSON RESPUESTA
{
"success": true,
"data": {
"number": "F001-17",
"filename": "20415963255-01-F001-17",
"external_id": "5a3b1a7e-2c71-4d20-b808-50ea0a82d6d2",
"hash": "tXp3cesBNfVwKXqm/b3kW84Q5vE=",
"qr":
VKw4bAAAEZElEQVR4nO2dwW7jMAxEk0X//5e7l0UQ1FyV4oydDPLesbElJQNSEkWx9+/v7xsk8+f
VAwAVJIwHCeNBwniQMB4kjAcJ40HCeJAwHiS7vSJtRPEsaDhPEgYTxIGM9fuiMPDwbdPS0AAA
AASUVORK5CYII="
},
"links": {
"xml": "http://demo26.multifacturaperunew.oo:8084/downloads/document/xml/5a3b1a7e-2c71-
4d20-b808-50ea0a82d6d2",
"pdf": "http://demo26.multifacturaperunew.oo:8084/downloads/document/pdf/5a3b1a7e-2c71-
4d20-b808-50ea0a82d6d2",
"cdr": "http://demo26.multifacturaperunew.oo:8084/downloads/document/cdr/5a3b1a7e-2c71-
4d20-b808-50ea0a82d6d2"
},
"response": {
"code": "0",
"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
{
"ubigeo": "150101",
"telefono": "427-1148"
},
"totales": {
"total_igv": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{
"cantidad": 2,
"total_igv": 18,
"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",
"hash": "WnFNru/saJAiNBfRZeYrxxbcTEQ=",
"qr":
VKw4bAAAEbUlEQVR4nO2d227jMAxEm8X+/y9334IAVhmKM3Y663MeE+vSDEhZFMU+vr+/vyCZ
P5+eAKggYTxIGA8SxoOE8SBhPEgYDxLGg4TxIGE8SBgPEsbzt/nc4/HQB3sNqR87HATcl7M69m
OZ/LLnJfbfqgYrjAcJ4+k60ifnubsBzU76Y7lc7u64ygSwwniQMB4kjGd7LXyldtz1SvBsu3ysuSQMhjh+
+DrW7oakbtvvR3kzwArjQcJ4JEdqofaotZtteqfa3aWnYWKF8SBhPJ93pE/6gQklkL37Rlp78t/ghLHCe
JAwHiSMR1oLlZXguBT1byNQfCWGE8SBiPFObe9Z/9yI5y5Fuz28Se/9JcVghz3wgkjEeKzjTvoVtc1
uDbQargbrx+cD7qDQ99YYX/AUgYDxLGY95U2E9K7YnxSoTl2IlyM9kFVhgPEsYjbSpqmkHwerhjb
8sOXSn3nZksO+nPyn6JA="
},
"links": {
"xml": "http://demo26.multifacturaperunew.oo:8084/downloads/document/xml/7d9feb66-16e9-
47a9-86fd-ebccdb662678",
"pdf": "http://demo26.multifacturaperunew.oo:8084/downloads/document/pdf/7d9feb66-16e9-
47a9-86fd-ebccdb662678",
"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.facturaperu.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.multifacturaperunew.oo:8084/downloads/document/cdr/7d9feb66-16e9-
47a9-86fd-ebccdb662678"
},
"response": {
"code": "0",
"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",
}
]
Ejemplo:
JSON A ENVIAR
{
"ubigeo": "150101",
"telefono": "427-1148"
},
"guias":[
{
"numero": "T001",
},
{
"numero": "T002",
}
],
"totales": {
"total_igv": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{
"cantidad": 2,
"total_igv": 18,
"total_item": 118
}
],
}
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",
"monto": 150.00
}
]
Ejemplo:
JSON A ENVIAR
{
"ubigeo": "150101",
"telefono": "427-1148"
},
"relacionados":[
{
"numero": "12",
"monto": 150.00
},
{
"numero": "15",
"monto": 150.00
}
],
"totales": {
"total_igv": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{
"cantidad": 2,
"total_igv": 18,
"total_item": 118
}
],
}
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
{
"ubigeo": "150101",
"telefono": "427-1148"
},
"totales": {
"total_igv": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{
"cantidad": 2,
"total_igv": 18,
"total_item": 118,
"datos_adicionales":[
{
"codigo": "5010",
"descripcion": "Numero de Placa",
"valor": "A7Q-986"
}
]
}
],
}
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",
"apellidos_y_nombres_o_razon_social": "EMBOTELLADORA DON JORGE S.A.C. EN
LIQUIDACION",
"ubigeo": "150101",
"direccion": "Av. Argentina 2458",
"telefono": "427-1148"
},
"totales": {
"total_igv": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{
"cantidad": 2,
"total_igv": 18,
"total_item": 118
}
],
}
4.13 FACTURA GRAVADA - IMPUESTO BOLSA PLASTICA
Ejemplo:
JSON A ENVIAR
{
"ubigeo": "150101",
"telefono": "427-1148"
},
"totales": {
"total_impuestos_bolsa_plastica": 0.2,
"total_igv": 18.00,
"total_valor": 100,
"total_venta": 118.2
},
"items":[
{
"descripcion":"Pepsi 3 lt",
"cantidad": 2,
"total_igv": 18,
"total_impuestos_bolsa_plastica": 0.2,
"total_item": 118
}
],
}
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",
"ubigeo": "150101",
"telefono": "427-1148"
},
"totales": {
"total_igv": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{
"cantidad": 2,
"total_igv": 18,
"total_item": 118
}
]
}
JSON RESPUESTA
{
"success": true,
"data": {
"number": "B001-1",
"filename": "20415963255-03-B001-1",
"external_id": "346135d8-b730-48e2-81f4-d00c9690f4ca",
"hash": "T3/grz45f3rK5xz7/PtlrNuhlCo=",
"qr":
VKw4bAAAEaUlEQVR4nO2d23LbMAwF607//5fTt9QTswhIHMvZ8e5jJYtszwCicOvt4+Pjl5D5/eoNy
BQlxKOEeJQQjxLiUUI8SohHCfEoIR4lxKOEeJQQzdfVqdTI7308Zf+c3lLMh/R5QQz8iRTpgElCdRkt
3ez4MRD5Hb+miFeJQQz8sc6SOTmuvUeK8sk4bZPlohHiXEo4R4MsMs40wiO3X/0e5akx7gVFdUj
VaIRwnxPHGAV+SBF5TNHzi0ZmgplWqu0QrxKCGel1VzSwqtEI8S4lFCPEqIRwnxKCEeJcSjhHiU
EI8S4lFCPEqIRwnx/AV6e7I2Yyb8aQAAAABJRU5ErkJggg=="
},
"links": {
"xml": "http://demo26.multifacturaperunew.oo:8084/downloads/document/xml/346135d8-b730-
48e2-81f4-d00c9690f4ca",
"pdf": "http://demo26.multifacturaperunew.oo:8084/downloads/document/pdf/346135d8-b730-
48e2-81f4-d00c9690f4ca",
"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",
"ubigeo": "150101",
"telefono": "427-1148"
},
"totales": {
"total_igv": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{
"cantidad": 2,
"total_igv": 18,
"total_item": 118
}
]
}
JSON RESPUESTA
{
"success": true,
"data": {
"number": "0004-1",
"filename": "20415963255-03-0004-1",
"external_id": "346135d8-b730-48e2-81f4-d00c9690f4ca",
"hash": "T3/grz45f3rK5xz7/PtlrNuhlCo=",
"qr":
VKw4bAAAEaUlEQVR4nO2d23LbMAwF607//5fTt9QTswhIHMvZ8e5jJYtszwCicOvt4+Pjl5D5/eoNy
BQlxKOEeJQQjxLiUUI8SohHCfEoIR4lxKOEeJQQzdfVqdTI7308Zf+c3lLMh/R5QQz8iRTpgElCdRkt
3ez4MRD5Hb+miFeJQQz8sc6SOTmuvUeK8sk4bZPlohHiXEo4R4MsMs40wiO3X/0e5akx7gVFdUj
VaIRwnxPHGAV+SBF5TNHzi0ZmgplWqu0QrxKCGel1VzSwqtEI8S4lFCPEqIRwnxKCEeJcSjhHiU
EI8S4lFCPEqIRwnx/AV6e7I2Yyb8aQAAAABJRU5ErkJggg=="
},
"links": {
"xml": "http://demo26.multifacturaperunew.oo:8084/downloads/document/xml/346135d8-b730-
48e2-81f4-d00c9690f4ca",
"pdf": "http://demo26.multifacturaperunew.oo:8084/downloads/document/pdf/346135d8-b730-
48e2-81f4-d00c9690f4ca",
"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",
"codigo_tipo_nota": "01",
"motivo_o_sustento_de_nota": "Error al emitir comprobante",
"documento_afectado": {
"external_id": "e5d6896a-0c42-4ad3-a482-5616e7fe50fb"
},
"ubigeo": "150101",
"telefono": "427-1148"
},
"totales": {
"total_igv": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{
"cantidad": 2,
"total_igv": 18,
"total_item": 118
}
]
}
JSON RESPUESTA
{
"success": true,
"data": {
"number": "FC01-1",
"filename": "20415963255-07-FC01-1",
"external_id": "92f5a566-512d-4159-b4c6-b6000e697328",
"hash": "56/PpGEK7d59qsaqc+yZoxbBzqw=",
"qr":
"iVBORw0KGgoAAAANSUhEUgAAAJYL3vNWZ7DCeJAwHs/JJnghWGE8SBgPEsaDhPEgYTxIGA
8SxoOE8SBhPEgYDxLGg4TxIGE8fwFHMbVs99tbGwAAAABJRU5ErkJggg=="
},
"links": {
"xml": "http://demo26.multifacturaperunew.oo:8084/downloads/document/xml/92f5a566-512d-
4159-b4c6-b6000e697328",
"pdf": "http://demo26.multifacturaperunew.oo:8084/downloads/document/pdf/92f5a566-512d-
4159-b4c6-b6000e697328",
"cdr": "http://demo26.multifacturaperunew.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": []
}}
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",
"codigo_tipo_nota": "01",
"motivo_o_sustento_de_nota": "Error al emitir comprobante",
"documento_afectado": {
"external_id": "e5d6896a-0c42-4ad3-a482-5616e7fe50fb"
},
"ubigeo": "150101",
"telefono": "427-1148"
},
"totales": {
"total_igv": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{
"cantidad": 2,
"total_igv": 18,
"total_item": 118
}
]
}
JSON RESPUESTA
{
"success": true,
"data": {
"number": "FD01-1",
"filename": "20415963255-08-FD01-1",
"external_id": "72a16a9d-382a-4ca4-a1ba-fadfbd68f2fa",
"hash": "cLYytvN0hmSxp8NIqKI4ULq0IH0=",
"qr":
VKw4bAAAEi0lEQVR4nO2d227jMAxEm0X//5U0RfcaBOzu4GLC9Af2BiLFcaDhPFcls0NLrDCeJAw
HiSMBwnjQcJ4kDAeJIwHCeNBwniQMB4kjAcJ40HCeP4CPz+yVDvGghIAAAAASUVORK5CYII="
},
"links": {
"xml": "http://demo26.multifacturaperunew.oo:8084/downloads/document/xml/72a16a9d-382a-
4ca4-a1ba-fadfbd68f2fa",
"pdf": "http://demo26.multifacturaperunew.oo:8084/downloads/document/pdf/72a16a9d-382a-
4ca4-a1ba-fadfbd68f2fa",
"cdr": "http://demo26.multifacturaperunew.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": []
}
}
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.facturaperu.pro/api/summaries
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.facturaperu.pro/api/summaries/status
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.multifacturaperunew.oo:8084/downloads/summary/xml/3832e508-fd01-
4c8f-99dc-2ab83e9fd53e",
"cdr": "http://demo26.multifacturaperunew.oo:8084/downloads/summary/cdr/3832e508-fd01-
4c8f-99dc-2ab83e9fd53e"
},
"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.facturaperu.pro/api/summaries
Ejemplo:
JSON A ENVIAR
{
"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.facturaperu.pro/api/summaries/status
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
{
"ticket": "1548517805048"
}
JSON RESPUESTA
{
"success": true,
"data": {
"filename": "20415963255-RC-20190126-6",
"external_id": "8f6568f5-e478-4ae2-8d21-0b91c0112e57"
},
"links": {
"xml": "http://demo26.multifacturaperunew.oo:8084/downloads/summary/xml/8f6568f5-e478-
4ae2-8d21-0b91c0112e57",
"cdr": "http://demo26.multifacturaperunew.oo:8084/downloads/summary/cdr/8f6568f5-e478-
4ae2-8d21-0b91c0112e57"
},
"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 culminada este procedimiento, deberá consultar el ticket de la

anulacion generada, se explicará en el siguiente punto.
Url: http://demo.facturaperu.pro/api/voided
Ejemplo:
JSON A ENVIAR
{
"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.facturaperu.pro/api/voided/status
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
{
"ticket": "1548517805048"
}
JSON RESPUESTA
{
"success": true,
"data": {
"filename": "20415963255-RA-20190126-1",
"external_id": "0a1382c6-e639-46fc-a8ae-d4659b63c4bd"
},
"links": {
"xml": "http://demo26.multifacturaperunew.oo:8084/downloads/voided/xml/0a1382c6-e639-
46fc-a8ae-d4659b63c4bd",
"cdr": "http://demo26.multifacturaperunew.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": []
}
}
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.facturaperu.pro/api/dispatches
Ejemplo:
JSON A ENVIAR
{
"serie_documento": "T001",
"datos_del_emisor": {
"ubigeo": "150101",
"telefono": "427-1148",
"codigo_del_domicilio_fiscal": "0000"
},
"nombre_comercial": "EMPRESA XYZ",
"ubigeo": "150101",
"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": {
"apellidos_y_nombres_o_razon_social": "aaaaaaaaa"
},
"chofer": {
"numero_documento": "4177874"
},
"numero_de_placa": "A01-1254",
"items":[
{
"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.multifacturaperunew.oo:8084/downloads/dispatch/xml/89f6931f-9be0-
4f92-80ad-8a7fbfce9160",
"pdf": "http://demo26.multifacturaperunew.oo:8084/downloads/dispatch/pdf/89f6931f-9be0-
4f92-80ad-8a7fbfce9160",
"cdr": "http://demo26.multifacturaperunew.oo:8084/downloads/dispatch/cdr/89f6931f-9be0-
4f92-80ad-8a7fbfce9160"
},
"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.facturaperu.pro/api/retentions
Ejemplo:
JSON A ENVIAR
{
"serie_documento": "R001",
"datos_del_emisor": {
"ubigeo": "150101",
"telefono": "427-1148",
"codigo_del_domicilio_fiscal": "0000"
},
"datos_del_proveedor":{
"nombre_comercial": "EMPRESA XYZ",
"ubigeo": "150101",
"telefono": "427-1148"
},
"codigo_tipo_retencion": "01",
"observaciones": "-",
"totales": {
"total_retenido": 30.00,
"total_pagado": 1000.00
},
"documentos":[
{
"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_a_pagar": 412.00,
},
{
"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_a_pagar": 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.multifacturaperunew.oo:8084/downloads/retention/xml/3249264a-fa7a-
4c02-a7ce-37e19186dba0",
"pdf": "http://demo26.multifacturaperunew.oo:8084/downloads/retention/pdf/3249264a-fa7a-
4c02-a7ce-37e19186dba0",
"cdr": "http://demo26.multifacturaperunew.oo:8084/downloads/retention/cdr/3249264a-fa7a-
4c02-a7ce-37e19186dba0"
},
"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
{
"ubigeo": "150101",
"correo_electronico": "micorreo@gmail.com",
"telefono": "427-1148"
},
"totales": {
"total_igv": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{
"cantidad": 2,
"total_igv": 18,
"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
{
"ubigeo": "150101",
"correo_electronico": "correo@gmail.com",
"telefono": "427-1148"
},
"totales": {
"total_igv": 18.00,
"total_valor": 100,
"total_venta": 118
},
"items":[
{
"cantidad": 2,
"total_igv": 18,
"total_item": 118
}
],
"acciones": {
"formato_pdf":"ticket"
}
}
12.3 REGISTRAR PRODUCTOS

Para registrar productos debe enviar hacia
Url: http://demo.facturaperu.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
}
}

Documentación API Rest

Cargado por

Información del documento

Descripción original:

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Documentación API Rest

Cargado por

Copyright:

Formatos disponibles

DOCUMENTACIÓN API REST

9. ANULACIÓN FACTURAS - NOTAS 43

10. GUÍA DE REMISIÓN 45

12. OTRAS FUNCIONALIDADES 50

Los documentos que se encuentran contemplados son:

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

2.1 USO DE LA URL Y TOKEN

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

Recomendamos construir el archivo JSON teniendo en cuenta las especificaciones

El archivo debe ser construido de tal forma que:

ESTRUCTURA JSON RESPUESTA

"success": true, => Proceso ejecutado correctamente

"qr": "iVBORw0KGgoAAAANSUhEUgAAAJY" => Usar para modificar la representacion impresa (PDF)

4.1 FACTURA GRAVADA

4.2 FACTURA INAFECTA

Generar una factura con item gravado y gratuito.

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.13 FACTURA GRAVADA - IMPUESTO BOLSA PLASTICA

5.1 BOLETA GRAVADA

5.2 BOLETA GRAVADA - CONTINGENCIA

6.1 NOTA CRÉDITO - FACTURA

6.2 NOTA DÉBITO - FACTURA

7.1 REGISTRAR Y ENVIAR RESÚMEN

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

8.1 REGISTRAR Y ENVIAR ANULACIÓN

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

9.1 REGISTRAR Y ENVIAR ANULACIÓN

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

10. GUÍA DE REMISIÓN

10.1 GENERAR GUIA DE REMISIÓN

11.1 GENERAR COMPROBANTE DE RETENCIÓN

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

12. OTRAS FUNCIONALIDADES

12.1 ENVIAR COMPROBANTE POR CORREO ELECTRÓNICO

12.3 REGISTRAR PRODUCTOS

También podría gustarte