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": "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/ 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": "demo@gmail.com", "telefono": "427-1148" }, "totales": { "total_exportacion": 0.00, "total_operaciones_gravadas": 0.00, "total_operaciones_inafectas": 118.00, "total_operaciones_exoneradas": 0.00, "total_operaciones_gratuitas": 0.00, "total_igv": 0.00, "total_impuestos": 0.00, "total_valor": 118, "total_venta": 118 }, "items":[ { "codigo_interno": "P0121", "descripcion":"Inca Kola 250 ml", "codigo_producto_sunat": "", "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": "demo@gmail.com", "telefono": "427-1148" }, "totales": { "total_exportacion": 0.00, "total_operaciones_gravadas": 100.00, "total_operaciones_inafectas": 0.00, "total_operaciones_exoneradas": 0.00, "total_operaciones_gratuitas": 100.00, "total_igv": 18.00, "total_impuestos": 18.00, "total_valor": 100, "total_venta": 118 }, "items":[ { "codigo_interno": "P0121", "descripcion":"Inca Kola 250 ml", "codigo_producto_sunat": "", "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": "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": "", "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": "demo@gmail.com", "telefono": "427-1148" }, "totales": { "total_exportacion": 0.00, "total_operaciones_gravadas": 0.00, "total_operaciones_inafectas": 0.00, "total_operaciones_exoneradas": 0.00, "total_operaciones_gratuitas": 100.00, "total_igv": 0.00, "total_impuestos": 0.00, "total_valor": 0.00, "total_venta": 0.00 }, "items":[ { "codigo_interno": "P0121", "descripcion":"Inca Kola 250 ml", "codigo_producto_sunat": "", "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": "demo@gmail.com", "telefono": "427-1148" }, "totales": { "total_exportacion": 0.00, "total_operaciones_gravadas": 0.00, "total_operaciones_inafectas": 0.00, "total_operaciones_exoneradas": 118.00, "total_operaciones_gratuitas": 0.00, "total_igv": 0.00, "total_impuestos": 0.00, "total_valor": 118, "total_venta": 118 }, "items":[ { "codigo_interno": "P0121", "descripcion":"Inca Kola 250 ml", "codigo_producto_sunat": "", "codigo_producto_gsl": "", "unidad_de_medida": "NIU", "cantidad": 2, "valor_unitario": 59, "codigo_tipo_precio": "01", "precio_unitario": 59, "codigo_tipo_afectacion_igv": "20", "total_base_igv": 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": "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 } ], "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": "demo@gmail.com", "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": "demo@gmail.com", "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": "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, "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": "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" } 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": "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_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": "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 } ] } 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": "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 } ] } 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": "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": "", "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": "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 } ] } 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": "demo@gmail.com", "telefono": "427-1148", "codigo_del_domicilio_fiscal": "0000" }, "datos_del_cliente_o_receptor":{ "codigo_tipo_documento_identidad": "6", "numero_documento": "10414711225", "apellidos_y_nombres_o_razon_social": "EMPRESA XYZ S.A.", "nombre_comercial": "EMPRESA XYZ", "codigo_pais": "PE", "ubigeo": "150101", "direccion": "Av. 2 de Mayo", "correo_electronico": "demo@gmail.com", "telefono": "427-1148" }, "observaciones": "aaaaaaaaaaaaaaa", "codigo_modo_transporte": "01", "codigo_motivo_traslado": "01", "descripcion_motivo_traslado": "El cliente solicito envia a su trabajo en ...", "fecha_de_traslado": "2019-01-16", "codigo_de_puerto": "", "indicador_de_transbordo": false, "unidad_peso_total": "KGM", "peso_total": 30.00, "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": "demo@gmail.com", "telefono": "427-1148", "codigo_del_domicilio_fiscal": "0000" }, "datos_del_proveedor":{ "codigo_tipo_documento_identidad": "6", "numero_documento": "10414711225", "apellidos_y_nombres_o_razon_social": "EMPRESA XYZ S.A.", "nombre_comercial": "EMPRESA XYZ", "codigo_pais": "PE", "ubigeo": "150101", "direccion": "Av. 2 de Mayo", "correo_electronico": "demo@gmail.com", "telefono": "427-1148" }, "codigo_tipo_retencion": "01", "observaciones": "-", "totales": { "total_retenido": 30.00, "total_pagado": 1000.00 }, "documentos":[ { "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": "micorreo@gmail.com", "telefono": "427-1148" }, "totales": { "total_exportacion": 0.00, "total_operaciones_gravadas": 100.00, "total_operaciones_inafectas": 0.00, "total_operaciones_exoneradas": 0.00, "total_operaciones_gratuitas": 0.00, "total_igv": 18.00, "total_impuestos": 18.00, "total_valor": 100, "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": "correo@gmail.com", "telefono": "427-1148" }, "totales": { "total_exportacion": 0.00, "total_operaciones_gravadas": 100.00, "total_operaciones_inafectas": 0.00, "total_operaciones_exoneradas": 0.00, "total_operaciones_gratuitas": 0.00, "total_igv": 18.00, "total_impuestos": 18.00, "total_valor": 100, "total_venta": 118 }, "items":[ { "codigo_interno": "P0121", "descripcion":"Inca Kola 250 ml", "codigo_producto_sunat": "51121703", "unidad_de_medida": "NIU", "cantidad": 2, "valor_unitario": 50, "codigo_tipo_precio": "01", "precio_unitario": 59, "codigo_tipo_afectacion_igv": "10", "total_base_igv": 100.00, "porcentaje_igv": 18, "total_igv": 18, "total_impuestos": 18, "total_valor_item": 100, "total_item": 118 } ], "acciones": { "formato_pdf":"ticket" } } 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 } }