acube_list_invoices
List invoices
Sent and received Italian e-invoices (SDI) of the account: uuid, invoice number and date, document type (TD01...), sender and recipient, amounts, marking and notification status. Filter by date, number, document type, party name or VAT number. GET /invoices.
Parameterspageordersignedorder_bycreated_todownloadedsender_namecreated_fromdocument_typeinvoice_numberitems_per_pagerecipient_name+4 more
acube_get_invoice
Get an invoice
One invoice by uuid: metadata plus the FatturaPA JSON payload (parties, lines, VAT, payment), or the XML file sent to the SDI. GET /invoices/{uuid}.
Parametersuuidrequiredformat
acube_list_invoice_notifications
List an invoice's SDI notifications
The SDI notifications of one invoice (delivery receipt RC, rejection NS, outcome NE, failed delivery MC, deadline expiry DT...), with their type, date and status: how you tell whether an invoice was delivered or rejected. GET /invoices/{uuid}/notifications.
Parametersuuidrequired
acube_get_notification
Get an SDI notification
One SDI notification by uuid, with its payload. GET /notifications/{uuid}.
Parametersuuidrequired
acube_get_invoice_stats
Get invoice statistics
Counters of invoices and notifications for a year (annual; monthly or daily detail only if A-Cube activated it), for the whole account or one fiscal id. GET /invoices/stats/{year}.
Parametersyearrequiredfiscal_id
acube_list_draft_invoices
List draft invoices
Draft invoices that were created but not yet sent to the SDI. Same filters as acube_list_invoices. GET /invoices/draft.
Parameterspageinvoice_numberitems_per_pagerecipient_nameinvoice_date_toinvoice_date_from
acube_get_draft_invoice
Get a draft invoice
One draft invoice by uuid, with its FatturaPA JSON content. GET /invoices/draft/{uuid}.
Parametersuuidrequired
acube_validate_invoice
Validate an invoice (no save)
Checks an invoice against the FatturaPA rules without creating or sending anything; returns the validation result or A-Cube's errors. POST /invoices/validate.
Parametersfattura_elettronica_bodyrequiredfattura_elettronica_header
acube_create_draft_invoice
Create a draft invoice
WRITE: saves a new invoice as a DRAFT in A-Cube. Nothing is sent to the SDI until acube_send_draft_invoice. Not idempotent: calling it twice creates two drafts. Validate first with acube_validate_invoice. POST /invoices/draft.
Parametersfattura_elettronica_bodyrequiredfattura_elettronica_header
acube_send_draft_invoice
Send a draft invoice to the SDI
WRITE: accepts a draft and transmits it to the Sistema di Interscambio. This is a legal act: a sent e-invoice cannot be recalled (only corrected with a credit note) and may be billed by A-Cube. Without confirm: true it only returns the draft for review. Show the draft to the user and get their explicit OK first. POST /invoices/draft/{uuid}/send.
Parametersuuidrequiredconfirm
acube_delete_draft_invoice
Delete a draft invoice
WRITE: permanently deletes a draft invoice (a draft only: a sent invoice answers 409). Without confirm: true it only returns the draft. DELETE /invoices/draft/{uuid}.
Parametersuuidrequiredconfirm
acube_list_receipts
List electronic receipts
Electronic commercial receipts (scontrini) with number, date, status, type (sale, void, return) and totals. GET /receipts.
Parameterspagetypestatusfiscal_iditems_per_pagedocument_numberdocument_date_todocument_date_from
acube_get_receipt
Get an electronic receipt
One electronic receipt by uuid: type, status, number, date, total and links to voiding or returned receipts (no line items: use acube_get_receipt_details). GET /receipts/{uuid}.
Parametersuuidrequired
acube_get_receipt_details
Get electronic receipt details
The line items and VAT, discount and taxable totals of one electronic receipt. GET /receipts/{uuid}/details.
Parametersuuidrequired
acube_list_business_registry_configurations
List business registry configurations
The businesses (fiscal ids) set up on the account, with which services are on: customer invoices, supplier invoices, receipts, signature, legal storage. GET /business-registry-configurations.
Parametersnamepageemailfiscal_iditems_per_pagereceipts_enabledsupplier_invoice_enabled
acube_get_business_registry_configuration
Get a business registry configuration
One business by fiscal id: name, email, enabled services and its webhook configurations. GET /business-registry-configurations/{fiscalId}.
Parametersfiscal_idrequired
acube_list_webhooks
List webhook configurations
The webhooks (events and target URLs) configured on the account. Authentication keys and tokens are never returned. GET /api-configurations.
Parameterspagefiscal_iditems_per_page
acube_list_numbering_sequences
List numbering sequences
The invoice numbering sequences (name, year, last number). GET /numbering-sequences.
Parameterspageyearsequence_nameitems_per_page
acube_get_current_numbering_sequence
Get the current numbering sequence
The sequence now in use for a sequence name. Its number is the LAST number used: the next invoice gets that number plus one. GET /numbering-sequences/current/{name}.
Parametersnamerequired
acube_list_jobs
List background jobs
Background jobs (invoice, report and zip downloads, F24 and daily receipt report downloads) with status ready, started, completed or error. GET /jobs.
Parameterspagestatusjob_typefiscal_iditems_per_page
acube_get_job
Get a background job
One background job by uuid with its status and result. GET /jobs/{uuid}.
Parametersuuidrequired
acube_verify_fiscal_id
Check a fiscal id
Checks whether a codice fiscale or partita IVA is valid. GET /verify/fiscal-id/{id}.
Parametersidrequired
acube_verify_company
Look up an Italian company
Basic registry data of an Italian company by VAT number (name, address, status), optionally with the split-payment check. GET /verify/company/{id}.
Parametersidrequiredcheck_split_payment
acube_get_recipient_code
Get the SDI recipient code
The account's 7-character SDI recipient code (codice destinatario), the address customers put on invoices they send to you. GET /users/me/recipient-code.
Takes no parameters.
