Perform invoice action

POST

https://integrators.prod.api.tabsplatform.com/v3/customers/:id/invoices/:invoiceId/actions

Authentication

Authorizationstring

API Key authentication via header

Path parameters

idstringRequired

Customer Id

invoiceIdstringRequired

Invoice Id

Request

Invoice actions for sending an invoice. Validation rules:

At least one of sendToErp or sendToCustomer must be true
sendToErp can be true while sendToCustomer is false (push to ERP only)
sendToCustomer can be true while sendToErp is false (email customer only; useful when no ERP is connected)
If sendToErp is true but the merchant has no ERP integration connected, the request is rejected
the field overrideInvoiceDate is optional

Invoice actions for sending an invoice. Validation rules: 1. At least one of sendToErp or sendToCustomer must be true 2. sendToErp can be true while sendToCustomer is false (push to ERP only) 3. sendToCustomer can be true while sendToErp is false (email customer only; useful when no ERP is connected) 4. If sendToErp is true but the merchant has no ERP integration connected, the request is rejected 5. the field overrideInvoiceDate is optional

SendInvoiceDtoobjectRequired

MarkInvoiceAsPendingDtoobjectRequired

MarkInvoiceToSentOffTabsDtoobjectRequired

MarkInvoiceAsScheduledDtoobjectRequired

MarkInvoiceAsVoidDtoobjectRequired

SendReminderEmailDtoobjectRequired

Response

Invoice marked as pending or sent off Tabs successfully

payloadobject

Response payload, will be empty when success is false

successboolean

Boolean with true=success, false=failure

messagestring

Plain-text description of the result

errorobject

json element with any error messages or warnings

Errors

400

Bad Request Error

500

Internal Server Error

$	curl -X POST https://integrators.prod.api.tabsplatform.com/v3/customers/123e4567-e89b-12d3-a456-426614174000/invoices/123e4567-e89b-12d3-a456-426614174000/actions \
>	-H "Authorization: <apiKey>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"action": "SEND",
>	"sendToErp": true,
>	"sendToCustomer": true,
>	"overrideInvoiceDate": false
>	}'

1	{
2	"message": "Invoice send job created, jobId: 9f8b7c6d-1234-4a56-b789-0a1b2c3d4e5f, please check the job status via /jobs/9f8b7c6d-1234-4a56-b789-0a1b2c3d4e5f"
3	}