Construir un archivo json

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:

  • Sea construido en codificación UTF-8.
  • No tenga caracteres especiales escondidos en una codificación distinta a UTF-8 o espacios innecesarios.
  • Que no tenga comillas dobles (“) en los atributos, en la descripción, dirección, ETC, ejemplo: “clavos 3” pulgadas” (esto interrumpe la estructura del json), se deben usar un escape, como por ejemplo: “clavos 3” pulgadas” o eliminar estas comillas.
  • La suma de cada línea del comprobante debe coincidir con los totales.

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:

  • OPERACIÓN 1: LISTAR CLIENTE
  • OPERACIÓN 2: LISTAR PROVEEDOR
  • OPERACIÓN 3: GENERAR CLIENTE
  • OPERACIÓN 4: GENERAR PROVEEDOR
  • OPERACIÓN 5: EDITAR CLIENTE
  • OPERACIÓN 6: EDITAR PROVEEDOR
  • OPERACIÓN 7: ELIMINAR CLIENTE
  • OPERACIÓN 8: ELIMINAR PROVEEDOR
  • OPERACIÓN 9: GENERAR FACTURA
  • OPERACIÓN 10: EDITAR FACTURA
  • OPERACIÓN 11: ELIMINAR FACTURA
  • OPERACIÓN 12: GENERAR BOLETA
  • OPERACIÓN 13: EDITAR BOLETA
  • OPERACIÓN 14: ELIMINAR BOLETA
  • OPERACIÓN 15: GENERAR NOTA DE VENTA
  • OPERACIÓN 16: EDITAR NOTA DE VENTA
  • OPERACIÓN 17: ELIMINAR NOTA DE VENTA
  • OPERACIÓN 18: GENERAR FACTURA ELECTRÓNICA

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

}