Cómo crear facturas desde API

Podemos crear facturas mediante la API enviando una petición POST al endpoint facturaclientes, posteriormente añadir las líneas con peticiones POST al endpoint lineafacturaclientes y finalmente actualizando los totales de la factura con una petición PUT a facturaclientes.

Es importante tener en cuenta que cuando creamos facturas desde la API, no se ejecutan las mismas clases y funciones auxiliares que nos permiten crear facturas con muy poco código, sino que le tenemos que enviar todo a la API. Por tanto tendremos que indicar el cliente de la factura, pero también su nombre, cifnif, dirección etc.

Cómo pasar los valores

Aunque la API responde siempre con JSON, para enviar los datos debemos hacerlo como lo haríamos a un formulario, es decir, mediante form URL encoded:

Paso 1: crear la cabecera

Hacemos una petición POST a /api/3/facturaclientes pasando por formulario el codcliente, nombre y cifnif del cliente.

Paso 2: añadir las líneas

Hacemos una petición POST por cada línea al endopint /api/3/lineafacturaclientes pasando por formulario el idfactura que hemos recibido en el paso 1 y la referencia, descripción, cantidad y pvpunitario (precio) de la línea.

Paso 3: actualizar los totales

Hacemos una petición PUT al endpoint de la factura, en este ejemplo es /api/2/facturaclientes/2 pasando por formulario los campos neto, netosindto (neto antes de aplicar descuentos globales), totaliva (la suma de los IVAs) y total.