Recomendamos construir el archivo JSON teniendo en cuenta las especificaciones indicadas en http://json.org; sin embargo en este documento encontrarás un link con muchísimos ejemplos de JSON para casi todos los casos.
El archivo debe ser construido de tal forma que:
TIPO | DESCRIPCIÓN |
Integer | Número entero |
String | Texto de 0 hasta 250 caracteres |
Text | Texto de 0 hasta 1000 caracteres |
Numeric | Número con decimales, con separador de punto para los decimales y sin separador de comas (,) de miles. Ejemplo: 2034.56 |
Date | Fecha formato DIA-MES-AÑO / DD-MM-YYYY (Separador con guiones medios). Ejemplo: 21-05-2017 |
Boolean | false = FALSO (En minúsculas) true = VERDADERO (En minúsculas) |
Se pueden hacer 4 tipos de operaciones con nuestra API:
A continuación puedes ver un ejemplo junto con la explicación de las estructuras.
JSON PARA ENVIAR | JSON DE RESPUESTA |
{ "action":"cliente-listar", "cliente_id":11 } | [ { "idempresa": 5, "idtipo_cliente": 1, "empresa": "NAGUAR PERU E.I.R.L.", "nombre_comercial": "", "ruc": "20513364963", "idestado": 1, "fecha_creacion": "2021-09-07", "fecha_modificacion": "2021-09-14", "logo_empresa": null, "icono_empresa": null, "bg_empresa": null, "tpl_cotizacion": null, "tpl_boleta": null, "tpl_factura": null, "tpl_guiaremision": null, "tpl_barcode": null, "tpl_barcode_lista": null, "tpl_cheque": null, "tpl_pedido": null, "tpl_oc": null, "tpl_cotizacion_pdf": null, "tpl_boleta_pdf": null, "tpl_factura_pdf": null, "codigo": "d45276d9b164d15ce5aafa6e9cde3590", "sis_empresa": 1, "idusuario": 100, "idforma": 0, "idpersonal": 2, "idsucursal": 5, "idasesor": 0, "idtipo_documento": 4, "descripcion": "", "notas_privadas": "" }, { "idempresa": 6, "idtipo_cliente": 1, "empresa": "GERARDO ANDRES ESPINOZA LA MATTA", "nombre_comercial": "", "ruc": "06807263", "idestado": 1, "fecha_creacion": "2021-09-08", "fecha_modificacion": "2021-09-14", "logo_empresa": null, "icono_empresa": null, "bg_empresa": null, "tpl_cotizacion": null, "tpl_boleta": null, "tpl_factura": null, "tpl_guiaremision": null, "tpl_barcode": null, "tpl_barcode_lista": null, "tpl_cheque": null, "tpl_pedido": null, "tpl_oc": null, "tpl_cotizacion_pdf": null, "tpl_boleta_pdf": null, "tpl_factura_pdf": null, "codigo": "15572c45ca2d1f4632a0e5af2b9e35ba", "sis_empresa": 1, "idusuario": 100, "idforma": 0, "idpersonal": 0, "idsucursal": 6, "idasesor": 0, "idtipo_documento": 2, "descripcion": "", "notas_privadas": "" } ] |
JSON PARA ENVIAR | JSON DE RESPUESTA |
{ "action":"proveedor-listar", "cliente_id":11 } | [ { "idempresa": 4, "idtipo_cliente": 2, "empresa": "MASS BUSINESS S.A.C.", "nombre_comercial": "", "ruc": "20557198882", "idestado": 1, "fecha_creacion": "2021-09-07", "fecha_modificacion": "2021-09-07", "logo_empresa": null, "icono_empresa": null, "bg_empresa": null, "tpl_cotizacion": null, "tpl_boleta": null, "tpl_factura": null, "tpl_guiaremision": null, "tpl_barcode": null, "tpl_barcode_lista": null, "tpl_cheque": null, "tpl_pedido": null, "tpl_oc": null, "tpl_cotizacion_pdf": null, "tpl_boleta_pdf": null, "tpl_factura_pdf": null, "codigo": "939bc25818be545da12c291f1d22cbac", "sis_empresa": 1, "idusuario": 100, "idforma": 0, "idpersonal": 1, "idsucursal": 4, "idasesor": 0, "idtipo_documento": 4, "descripcion": "", "notas_privadas": "" }, { "idempresa": 11, "idtipo_cliente": 2, "empresa": "proveedores SAC", "nombre_comercial": "proveedores SAC", "ruc": "20550117968", "idestado": 1, "fecha_creacion": null, "fecha_modificacion": "2021-09-27", "logo_empresa": null, "icono_empresa": null, "bg_empresa": null, "tpl_cotizacion": null, "tpl_boleta": null, "tpl_factura": null, "tpl_guiaremision": null, "tpl_barcode": null, "tpl_barcode_lista": null, "tpl_cheque": null, "tpl_pedido": null, "tpl_oc": null, "tpl_cotizacion_pdf": null, "tpl_boleta_pdf": null, "tpl_factura_pdf": null, "codigo": "32", "sis_empresa": 1, "idusuario": 100, "idforma": 0, "idpersonal": 9, "idsucursal": 11, "idasesor": 0, "idtipo_documento": 4, "descripcion": null, "notas_privadas": null } ] |
JSON PARA ENVIAR | JSON DE RESPUESTA |
{ "action":"cliente-nuevo", "cliente_nombre":"empresa SAC", "cliente_num_doc": 20550117968, "cliente_idtipo_documento": "4", "contacto_nombre": “Juan”, “contacto_apellido”:”Perez”, “contacto_dni”:”10000001”, “contacto_correo”:”[email protected]”, “contacto_telefono”:”7777777”, “contacto_celular”:”999999999”, “contacto_sexo”:1, “sucursal_nombre”:”Dirección 1”, “sucursal_telefono”:”7777778”, “sucursal_direccion”:”Av. Primavera 201”, “sucursal_distrito”:1253, “sucursal_provincia”:127, “sucursal_departamento”:15, “sucursal_pais”:179 } | { "respuesta": "Se registró con éxito", "id": 11 } |
JSON PARA ENVIAR | JSON DE RESPUESTA |
{ "action":"proveedor-nuevo", "proveedor_nombre":"Andess SAC", "proveedor_num_doc": 20550117969, "proveedor_idtipo_documento": "4", "contacto_nombre": “camila”, “contacto_apellido”:”Gomez”, “contacto_dni”:”10000002”, “contacto_correo”:”[email protected]”, “contacto_telefono”:”7777779”, “contacto_celular”:”999999998”, “contacto_sexo”:1, “sucursal_nombre”:”Dirección 2”, “sucursal_telefono”:”7777779”, “sucursal_direccion”:”Av. Precursores 1”, “sucursal_distrito”:1253, “sucursal_provincia”:127, “sucursal_departamento”:15, “sucursal_pais”:179 } | { "respuesta": "Se registró con éxito", "id": 12 } |
JSON PARA ENVIAR | JSON DE RESPUESTA |
{ "action":"cliente-editar", "cliente_id":11, "cliente_nombre":"empresa SAC", "cliente_num_doc": 20550117968, "contacto_nombre": “Juan”, “contacto_apellido”:”Perez”, “contacto_dni”:”10000001”, “contacto_correo”:”[email protected]”, “contacto_telefono”:”7777777”, “contacto_celular”:”999999999”, “contacto_sexo”:1, “sucursal_nombre”:”Dirección 1”, “sucursal_telefono”:”7777778”, “sucursal_direccion”:”Av. Primavera 201”, “sucursal_distrito”:1253, “sucursal_provincia”:127, “sucursal_departamento”:15, “sucursal_pais”:179 } | { "respuesta": "Se editó el cliente con éxito", "id": 11 } |
JSON PARA ENVIAR | JSON DE RESPUESTA |
{ "action":"proveedor-editar", "proveedor_id":12, "proveedor_nombre":"Andess SAC", "proveedor_num_doc": 20550117969, "contacto_nombre": “camila”, “contacto_apellido”:”Gomez”, “contacto_dni”:”10000002”, “contacto_correo”:”[email protected]”, “contacto_telefono”:”7777779”, “contacto_celular”:”999999998”, “contacto_sexo”:2, “sucursal_nombre”:”Dirección 2”, “sucursal_telefono”:”7777779”, “sucursal_direccion”:”Av. Precursores 1”, “sucursal_distrito”:1253, “sucursal_provincia”:127, “sucursal_departamento”:15, “sucursal_pais”:179 } | { "respuesta": "Se editó el proveedor con éxito", "id": 12 } |
JSON PARA ENVIAR | JSON DE RESPUESTA |
{ "action":"cliente-eliminar", "cliente_id":11 } | { "respuesta": "Se eliminó el cliente con éxito", "id": 11 } |
JSON PARA ENVIAR | JSON DE RESPUESTA |
{ "action":"proveedor-eliminar", "proveedor_id":12 } | { "respuesta": "Se eliminó el proveedor con éxito", "id": 12 } |
JSON PARA ENVIAR | JSON DE RESPUESTA |
{ "action":"factura-nuevo", "factura_estado":1, "factura_cliente":2, "factura_idmoneda":1, "factura_fecha":"2021-09-10", "factura_fechapago":"2021-09-11", "factura_observaciones":"Este es un contenido de prueba", "factura_idcontacto":1, "factura_tipooperacion":1, "factura_detraccion":0, "factura_porcentaje_detraccion":0, "factura_idpago":1, "factura_hora_creacion":"14:25:32", "factura_formapago_cpe":"1", "detalle":[ { "cod_num":43677910, "cantidad":1, "precio_unit":20.5, "num_serie":"ABC132", "descuento":10, "descripcion":"Este es un producto de prueba añadido a la factura" } ] } | { "respuesta": "Se registró la Factura de venta con éxito", "id": "21" } |
JSON PARA ENVIAR | JSON DE RESPUESTA |
{ "action":"factura-editar", "factura_id":21, "factura_estado":1, "factura_cliente":5, "factura_idmoneda":1, "factura_fecha":"2021-09-10", "factura_fechapago":"2021-09-11", "factura_observaciones":"Este contenido fue editado333", "factura_idcontacto":2, "factura_tipooperacion":1, "factura_detraccion":0, "factura_porcentaje_detraccion":0, "factura_idpago":1, "factura_hora_creacion":"14:25:32", "factura_formapago_cpe":"1", "detalle":[ { "cod_num":35363770, "cantidad":1, "precio_unit":200, "num_serie":"ABC132", "descuento":50, "descripcion":"Este es un producto de prueba añadido a la factura" } ] }
| { "respuesta": "Se editó la Factura de venta con éxito", "id": 21 }
|
JSON PARA ENVIAR | JSON DE RESPUESTA |
{ "action":"factura-eliminar", "factura_id":21 }
| { "respuesta": "Se eliminó la Factura de venta con éxito", "id": 21 }
|
JSON PARA ENVIAR | JSON DE RESPUESTA |
{ "action":"boleta-nuevo", "factura_estado":1, "factura_cliente":2, "factura_idmoneda":1, "factura_fecha":"2021-09-10", "factura_fechapago":"2021-09-11", "factura_observaciones":"Este es un contenido de prueba", "factura_idcontacto":1, "factura_tipooperacion":1, "factura_detraccion":0, "factura_porcentaje_detraccion":0, "factura_idpago":1, "factura_hora_creacion":"14:25:32", "factura_formapago_cpe":"1", "detalle":[ { "cod_num":43677910, "cantidad":1, "precio_unit":20.5, "num_serie":"ABC132", "descuento":10, "descripcion":"Este es un producto de prueba añadido a la factura" } ] } | { "respuesta": "Se registró la Boleta de venta con éxito", "id": "22" } |
JSON PARA ENVIAR | JSON DE RESPUESTA |
{ "action":"boleta-editar", "factura_id":22, "factura_estado":1, "factura_cliente":5, "factura_idmoneda":1, "factura_fecha":"2021-09-10", "factura_fechapago":"2021-09-11", "factura_observaciones":"Este contenido fue editado333", "factura_idcontacto":2, "factura_tipooperacion":1, "factura_detraccion":0, "factura_porcentaje_detraccion":0, "factura_idpago":1, "factura_hora_creacion":"14:25:32", "factura_formapago_cpe":"1", "detalle":[ { "cod_num":35363770, "cantidad":1, "precio_unit":200, "num_serie":"ABC132", "descuento":50, "descripcion":"Este es un producto de prueba añadido a la factura" } ] }
| { "respuesta": "Se editó la Boleta de venta con éxito", "id": 22 }
|
JSON PARA ENVIAR | JSON DE RESPUESTA |
{ "action":"boleta-eliminar", "factura_id":22 }
| { "respuesta": "Se eliminó la Boleta de venta con éxito", "id": 22 }
|
JSON PARA ENVIAR | JSON DE RESPUESTA |
{ "action":"nota-nuevo", "factura_estado":1, "factura_cliente":2, "factura_idmoneda":1, "factura_fecha":"2021-09-10", "factura_fechapago":"2021-09-11", "factura_observaciones":"Este es un contenido de prueba", "factura_idcontacto":1, "factura_tipooperacion":1, "factura_detraccion":0, "factura_porcentaje_detraccion":0, "factura_idpago":1, "factura_hora_creacion":"14:25:32", "factura_formapago_cpe":"1", "detalle":[ { "cod_num":43677910, "cantidad":1, "precio_unit":20.5, "num_serie":"ABC132", "descuento":10, "descripcion":"Este es un producto de prueba añadido a la factura" } ] } | { "respuesta": "Se registró la Nota de venta con éxito", "id": "23" } |
JSON PARA ENVIAR | JSON DE RESPUESTA |
{ "action":"nota-editar", "factura_id":23, "factura_estado":1, "factura_cliente":5, "factura_idmoneda":1, "factura_fecha":"2021-09-10", "factura_fechapago":"2021-09-11", "factura_observaciones":"Este contenido fue editado333", "factura_idcontacto":2, "factura_tipooperacion":1, "factura_detraccion":0, "factura_porcentaje_detraccion":0, "factura_idpago":1, "factura_hora_creacion":"14:25:32", "factura_formapago_cpe":"1", "detalle":[ { "cod_num":35363770, "cantidad":1, "precio_unit":200, "num_serie":"ABC132", "descuento":50, "descripcion":"Este es un producto de prueba añadido a la factura" } ] }
| { "respuesta": "Se editó la Nota de venta con éxito", "id": 23 }
|
JSON PARA ENVIAR | JSON DE RESPUESTA |
{ "action":"nota-eliminar", "factura_id":23 }
| { "respuesta": "Se eliminó la Nota de venta con éxito", "id": 23 }
|
JSON PARA ENVIAR | JSON DE RESPUESTA |
{ "action":"fesunat-enviar", "id":20, "tipodoc":2 }
| { "respuesta": "La Factura/ Boleta/ Nota de venta numero 0001-00000001, ha sido aceptada }
|