Skip to main content

Pending Received Documents APIs and more!!!

· 3 min read
Mauro Valota
Mauro Valota
API Engineer @ Fatture in Cloud

This time, we have big news regarding our APIs and Webhooks!

The changes include new Pending Received Documents APIs, a bugfix on the Self Invoices Webhooks, and an improved Errors documentation.

📥  Pending Received Documents​

You asked, we provided. Our Pending Received Documents are finally out!

We added these two methods to our APIs:

These methods, in combination with the dedicated webhook notification type, will help you get notified for new pending documents directly on your integration.

You can check the dedicated guide to discover more about this release that we hope you'll appreciate.

🔔  Self Invoices Webhooks​

We noticed that our OpenAPI Specification and documentation listed the wrong Webhook Notification Types for the Self Invoices.

The wrong notification types included:

  • it.fattureincloud.webhooks.issued_documents.self_invoices.create
  • it.fattureincloud.webhooks.issued_documents.self_invoices.update
  • it.fattureincloud.webhooks.issued_documents.self_invoices.delete
  • it.fattureincloud.webhooks.issued_documents.self_invoices.email_sent

You were actually able to subscribe to these events, but no notifications were sent by our Webhooks.

The correct notification types are the following:

  • it.fattureincloud.webhooks.issued_documents.self_supplier_invoices.create
  • it.fattureincloud.webhooks.issued_documents.self_supplier_invoices.update
  • it.fattureincloud.webhooks.issued_documents.self_supplier_invoices.delete
  • it.fattureincloud.webhooks.issued_documents.self_supplier_invoices.email_sent
  • it.fattureincloud.webhooks.issued_documents.self_own_invoices.create
  • it.fattureincloud.webhooks.issued_documents.self_own_invoices.update
  • it.fattureincloud.webhooks.issued_documents.self_own_invoices.delete
  • it.fattureincloud.webhooks.issued_documents.self_own_invoices.email_sent

As you can see, the events are basically the same, but you have different types for self_supplier_invoices and self_own_invoices.

The existing subscriptions were updated to match the two new notification types, so if you're interested in these events, you don't have to do anything. If, instead, you are not interested in these kinds of events, you can use the Delete Subscription or Modify Subscription methods to modify your current subscriptions.

⚠️  Errors Management​

We updated our Errors, which now contains a more detailed explanation of the most common errors returned by our APIs and the related response body.

We also described the extra field, which is returned in the Totals Error response body and will help you resolve your API requests.

🚀  SDKs and Zapier​

Our SDKs and the Zapier integration will be updated as soon as possible to include all the changes explained above, so you'll need a little more patience; we will update this page to keep you updated when a new version is available. You can also check the GitHub pages of our SDKs or the related package manager pages to check if a new version is available.

Stay tuned!