@beel_es/sdk 1.3.0 → 2.0.0

package/README.md

@@ -62,8 +62,22 @@ const company = beel.company('company-uuid');
 // Invoices — full lifecycle
 const { invoices, pagination } = await company.invoices.list({ status: 'ISSUED' });
 await company.invoices.issue('invoice-uuid');
-await company.invoices.void('invoice-uuid', { reason: 'Billing error' });
-await company.invoices.createCorrective('invoice-uuid', { ... });
+// A void is only for an invoice issued by mistake; `issued_in_error: true` is required
+// once it has been sent or paid. An operation that did happen gets a corrective instead.
+await company.invoices.void('invoice-uuid', { reason: 'Duplicate', issued_in_error: true });
+await company.invoices.createCorrective('invoice-uuid', {
+  rectification_type: 'PARTIAL',
+  rectification_code: 'R1',
+  reason: 'Discount granted after the sale',
+  circumstance_date: '2026-09-01', // when the art. 80 circumstance happened, if any
+  lines: [ ... ],
+});
+// Exchange issued simplified invoices for a full one with the customer identified
+await company.invoices.createSimplifiedExchange({
+  simplified_invoice_ids: ['simplified-uuid'],
+  recipient: { customer_id: 'customer-uuid' },
+});
+const records = await company.invoices.verifactuRecords('invoice-uuid'); // registration, cancellation
 const pdf = await company.invoices.getPdf('invoice-uuid');
 
 // Customers, products, series
@@ -134,7 +148,7 @@ wrapper is written by hand. `beel.raw` lets you call anything in the contract to
 without waiting for a release:
 
 ```typescript
-const { data } = await beel.raw.GET('/v1/companies/{company_id}/logo', {
+const { data } = await beel.raw.GET('/v1/companies/{company_id}/invoice-customization', {
   params: { path: { company_id: 'company-uuid' } },
 });
 ```
@@ -290,8 +304,11 @@ app.post('/webhooks/beel', express.raw({ type: 'application/json' }), (req, res)
       req.headers['beel-signature'] as string,
     );
 
+    // "Send test" deliveries carry a synthetic `data`: acknowledge and stop.
+    if (event.test) return res.status(200).send('OK');
+
     if (event.type === 'verifactu.status.updated') {
-      console.log(event.data.new_status); // 'ACCEPTED' | 'REJECTED'
+      console.log(event.data.new_status); // 'PENDING' | 'ACCEPTED' | 'REJECTED' | 'VOIDED'
     }
 
     res.status(200).send('OK');