0.0.26 • Published 3 years ago
@rayan-waapi/vos_factures v0.0.26
VOS FACTURES
Package to help with the API from "vosFactures"
Authentication
To start you'll need to give to the API your credentials from vosFactures.
import vosFacturesAPI from "@rayan-waapi/vos_factures";
if (await vosFacturesAPI.authenticate(API_TOKEN)) {
// The package is initialized
} else {
// We've got an error
}
Client
To create a client
import vosFacturesAPI from "@rayan-waapi/vos_factures";
// vosFacturesAPI is initialized
const client = new vosFacturesAPI.Clients.Client();
client.name = "John Smith";
// Equal to
const client = new vosFacturesAPI.Clients.Client({ name: "John Smith" });
// Then save it
await client.save();
console.log(client.id);
To update a client
import vosFacturesAPI from "@rayan-waapi/vos_factures";
// vosFacturesAPI is initialized
const client = new vosFacturesAPI.Clients.Client({ name: "John Smith" });
// Then save it
await client.save();
client.name = "John Doe";
await client.update();
To delete a client
import vosFacturesAPI from "@rayan-waapi/vos_factures";
// vosFacturesAPI is initialized
const client = new vosFacturesAPI.Clients.Client({ name: "John Smith" });
// Then save it
await client.save();
await client.remove();
To retrieve a client
import vosFacturesAPI from "@rayan-waapi/vos_factures";
// vosFacturesAPI is initialized
const client = await vosFacturesAPI.Clients.Client.findById(clientId);
To retrieve many clients
import vosFacturesAPI from "@rayan-waapi/vos_factures";
// vosFacturesAPI is initialized
const clients = await vosFacturesAPI.Clients.Client.findBy({name: "John"}); // array of Client
To retrieve all clients
import vosFacturesAPI from "@rayan-waapi/vos_factures";
// vosFacturesAPI is initialized
const clients = await vosFacturesAPI.Clients.Client.findAll(); // array of Client
To retrieve invoices from a client
import vosFacturesAPI from "@rayan-waapi/vos_factures";
// vosFacturesAPI is initialized
const client = await vosFacturesAPI.Clients.Client.findById(clientId);
await client.getInvoices();
Products
Create a product
import vosFacturesAPI from "@rayan-waapi/vos_factures";
// vosFacturesAPI is initialized
const product = new vosFacturesAPI.Products.Product({
name: "MY_CAKE",
code: "CAKEISLIE",
priceGross: "200.00",
currency: "EUR",
tax: "20"
});
await product.save()
To update a product
import vosFacturesAPI from "@rayan-waapi/vos_factures";
// vosFacturesAPI is initialized
const product = new vosFacturesAPI.Products.Product({
name: "MY_CAKE",
code: "CAKEISLIE",
priceGross: "200.00",
currency: "EUR",
tax: "20"
});
// Then save it
await product.save();
product.name = "OUR_CAKE";
await product.update();
To delete a product
import vosFacturesAPI from "@rayan-waapi/vos_factures";
// vosFacturesAPI is initialized
const product = new vosFacturesAPI.Products.Product({
name: "MY_CAKE",
code: "CAKEISLIE",
priceGross: "200.00",
currency: "EUR",
tax: "20"
});
// Then save it
await product.save();
await product.remove();
To retrieve a product
import vosFacturesAPI from "@rayan-waapi/vos_factures";
// vosFacturesAPI is initialized
const product = await vosFacturesAPI.Products.Product.findById(productId);
To retrieve many products
import vosFacturesAPI from "@rayan-waapi/vos_factures";
// vosFacturesAPI is initialized
const products = await vosFacturesAPI.Products.Product.findBy({currency: "EUR"}); // array of Product
To retrieve all products
import vosFacturesAPI from "@rayan-waapi/vos_factures";
// vosFacturesAPI is initialized
const products = await vosFacturesAPI.Products.Product.findAll(); // array of Product
Invoices
Create a invoice
import vosFacturesAPI from "@rayan-waapi/vos_factures";
// vosFacturesAPI is initialized
const invoice = new vosFacturesAPI.Invoices.Invoice({
clientId,
kind: "estimate"
});
invoice.addProduct(product)
await invoice.save()
To update a invoice
import vosFacturesAPI from "@rayan-waapi/vos_factures";
//....
await invoice.update();
To delete a invoice
import vosFacturesAPI from "@rayan-waapi/vos_factures";
//....
await invoice.remove();
To retrieve a invoice
import vosFacturesAPI from "@rayan-waapi/vos_factures";
// vosFacturesAPI is initialized
const invoice = await vosFacturesAPI.Invoices.Invoice.findById(invoiceId);
To retrieve the client object from an invoice
import vosFacturesAPI from "@rayan-waapi/vos_factures";
// vosFacturesAPI is initialized
const invoice = await vosFacturesAPI.Invoices.Invoice.findById(invoiceId);
await invoice.getClient(); // will return a Client
To retrieve many invoices
import vosFacturesAPI from "@rayan-waapi/vos_factures";
// vosFacturesAPI is initialized
const invoices = await vosFacturesAPI.Invoices.Invoice.findBy({clientId: clientId}); // array of Invoice
To retrieve all invoices
import vosFacturesAPI from "@rayan-waapi/vos_factures";
// vosFacturesAPI is initialized
const invoices = await vosFacturesAPI.Invoices.Invoice.findAll(); // array of Invoice
To create an invoice from an other invoice
import vosFacturesAPI from "@rayan-waapi/vos_factures";
// vosFacturesAPI is initialized
const invoice = await vosFacturesAPI.Invoices.Invoice.findById(invoiceId);
const newInvoice = invoice.duplicateAs("vat")
await newInvoice.save();
TESTS
You can run test thanks to npm test
inside the package folder, before that you have to complete the .env
file
0.0.26
3 years ago
0.0.25
4 years ago
0.0.22
4 years ago
0.0.21
4 years ago
0.0.20
4 years ago
0.0.18
4 years ago
0.0.19
4 years ago
0.0.17
4 years ago
0.0.16
4 years ago
0.0.15
4 years ago
0.0.13
4 years ago
0.0.14
4 years ago
0.0.12
4 years ago
0.0.11
4 years ago
0.0.10
4 years ago
0.0.9
4 years ago
0.0.8
4 years ago
0.0.7
4 years ago
0.0.6
4 years ago
0.0.5
4 years ago
0.0.4
4 years ago