The Biziq API is a collection of web services that allow you to receive payments from customers, be notified of those payments, refund them if necessary, among others.
The API endpoints are available through the following domains:
https://sandboxapi.biziq.app/
https://api.biziq.app/
To check your credentials for the API you can go to the API tab on our software.
Server-to-server requests to the API you must be authenticated via Account ID and API Key. If you are associated to more than one company you may also need the Company VAT. To do so, include the following HTTP headers in your API requests:
accountid: <YOUR_ACCOUNT_ID>
apikey: <YOUR_API_KEY>
company_vat: <YOUR_COMPANY_VAT>
When these headers are missing or incorrect, a 401
HTTP status code is returned.
Biziq uses HTTP response status codes to indicate the success or failure of your API requests. If your request fails, Biziq returns an error using the appropriate status code.
In general, there are three status code ranges you can expect:
2xx
success status codes confirm that your request worked as expected4xx
error status codes indicate an error because of the information provided (for example, a required parameter was omitted).5xx
error status codes are rare and indicate an error with Biziq’s servers.Some 4xx
errors that could be handled programmatically include an error code (a short string with a brief explanation) as a value for code
.
Below is a list of possible error codes that can be returned, along with additional information about how to resolve them.
This error can have multiple potential causes. Here are some examples:
This error can only have one cause, you provided an invalid/unsupported content type header.
This error happens when you provide a bad formated JSON payload.
This error indicates the information provided was incorrect of insufficient (for example, a required parameter was omitted).
This error indicates that an unexpected error ocurred on our servers.
This segment outlines various requests that users can execute to effectively manage their personal information within the Biziq platform.
To successfully create a user, users are only required to furnish the AUTHORIZATIONS parameters.
address | string Use's address |
city | string User's city |
country required | string User's country |
birth_date | date User's birth date |
name required | string User's name |
email required | email User's email |
password required | string User's password |
confirm_password required | string Must be equal to password |
password required | string User's password |
postal_code | string User's postal code |
{- "response": "success",
- "user": {
- "credentials": {
- "accountid": "2123",
- "apikey": "2123-21dqwd12-cwq2132r"
}
}
}
To successfully get user's data, users are only required to furnish the AUTHORIZATIONS parameters.
{- "response": "success",
- "user": {
- "address": "Praça Artur Santos Silva 74",
- "birth_date": "Porto",
- "city": "Porto",
- "country": "PT",
- "companies": {
- "123456789": "Company"
}, - "credentials": {
- "accountid": "2123",
- "apikey": "2123-21dqwd12-cwq2132r"
}, - "name": "User",
- "postal_code": "4200-534"
}
}
This segment provides comprehensive insights and guidelines on leveraging the company settings capabilities of the Biziq API.
To successfully get company's data, users are only required to furnish the AUTHORIZATIONS parameters.
{- "response": "success",
- "message": {
- "company": {
- "address": {
- "address": "Praça Artur Santos Silva 74",
- "city": "Porto",
- "country": "PT",
- "postal_code": "4200-534"
}, - "business_data": {
- "email": "Jonh Doe",
- "fax": "22 206 1597",
- "mobile": "22 206 1597",
- "phone": "22 206 1597"
}, - "conservatory": "Conservatoria Registo Civil do Porto",
- "name": "Intelidus",
- "vat": "999111000",
- "type": "Undefined",
- "share_capital": "1000"
}
}
}
To successfully create a Company, users are required to furnish the relevant data within the request body, formatted in JSON. The body parameters integral to this request include:
ask_access | boolean IF the Company already exists, this paramenter will help create a request to access the company |
address required | string Company's address |
city required | string Company's city |
conservatory | string Company's conservatory |
company_type | string Company's type |
country required | string Company's country |
name required | string Company's name |
new_services required | boolean If you want to receive updates on the services available for your Company |
services required | Array of arrays The Biziq services you want to use in your Company |
share_capital required | number The Company's share capital |
postal_code required | string Company's address postal code |
vat_number required | string Company's VAT Number |
{- "response": "success",
- "message": {
- "company": {
- "address": {
- "address": "Praça Artur Santos Silva 74",
- "city": "Porto",
- "country": "PT",
- "postal_code": "4200-534"
}, - "business_data": {
- "email": "Jonh Doe",
- "fax": "22 206 1597",
- "mobile": "22 206 1597",
- "phone": "22 206 1597"
}, - "conservatory": "Conservatoria Registo Civil do Porto",
- "name": "Intelidus",
- "vat": "999111000",
- "type": "Undefined",
- "share_capital": "1000"
}
}
}
To successfully update a Company, users are required to furnish the relevant data within the request body, formatted in JSON. The body parameters integral to this request include:
city required | string Company's address |
business_email required | string Company's email |
city required | string Company's address city |
postal_code required | string Company's address postal code |
{- "response": "success",
- "message": {
- "company": {
- "address": {
- "address": "Praça Artur Santos Silva 74",
- "city": "Porto",
- "country": "PT",
- "postal_code": "4200-534"
}, - "business_data": {
- "email": "Jonh Doe",
- "fax": "22 206 1597",
- "mobile": "22 206 1597",
- "phone": "22 206 1597"
}, - "conservatory": "Conservatoria Registo Civil do Porto",
- "name": "Intelidus",
- "vat": "999111000",
- "type": "Undefined",
- "share_capital": "1000"
}
}
}
This segment provides comprehensive insights and guidelines on leveraging the invoicing capabilities of the Biziq API. Whether you’re initiating transactions, managing financial records, or enhancing your invoicing workflows, this section serves as your go-to resource. Endpoints for managing Clients under the Invoicing section.
To successfully get company's clients, users are required to furnish the relevant data within the request body, formatted in JSON. The body parameters integral to this request include:
name | string To search for clients with that name |
code | string To search for clients with that code |
{- "response": "success",
- "message": {
- "Client": {
- "address": "Conservatoria Registo Civil do Porto",
- "city": "Porto",
- "country": "PT",
- "postal_code": "1000-000",
- "vat_number": "999111000"
}
}
}
This segment provides comprehensive insights and guidelines on leveraging the invoicing capabilities of the Biziq API. Whether you’re initiating transactions, managing financial records, or enhancing your invoicing workflows, this section serves as your go-to resource. Endpoints for managing credit notes under the Invoicing section.
date | string <Y-m-d> Date of the Credit Note |
name required | string Name of the Original Document |
serie required | string Name of the Series, belonging to the same Company as the Original Document, of the Credit Note type |
reason required | string Reason why the Credit Note is being created |
object Items present in the Original Document (optional; if not provided, all items available in the Original Document will be used). |
{- "response": "success",
- "message": {
- "document": {
- "name": "NC BETA/000001",
- "status": "final",
- "reason": "Refund",
- "date": "2024-01-01",
- "discount": "0.00000",
- "vat": "0.690000",
- "subtotal": "3.00000",
- "total": "3.690000"
}
}
}
name | string Invoice Identification |
document_id | string Document Identification |
name required | string |
document_id | string |
{- "name": "string",
- "document_id": "string"
}
{- "response": "success",
- "message": {
- "document": {
- "invoice": {
- "name": "NC BETA/000001",
- "status": "final",
- "inv_date": "2024-01-01 00:00:00",
- "discount": "0.00000",
- "vat": "0.690000",
- "subtotal": "3.00000",
- "total": "3.690000"
}, - "client": {
- "name": "Jonh Doe",
- "address": "Street 21, n22",
- "city": "Porto",
- "country": "PT",
- "vat_number": "264107691"
}, - "channel": {
- "name": "Jonh Doe",
- "address": "Street 11, n29",
- "city": "Porto",
- "country": "PT"
}
}
}
}
name | string Document Identification |
document_id | string Document Identification |
status required | string Enum: "final" "canceled" "deleted" The status you want to put your Document |
cancelation_reason | string The reason why you want to cancel your Document |
name required | string |
document_id | string |
status required | string |
cancelation_reason | string |
{- "name": "string",
- "document_id": "string",
- "status": "string",
- "cancelation_reason": "string"
}
{- "response": "success",
- "message": "Your document was successfully finalized"
}
This segment provides comprehensive insights and guidelines on leveraging the invoicing capabilities of the Biziq API. Whether you’re initiating transactions, managing financial records, or enhancing your invoicing workflows, this section serves as your go-to resource. Endpoints for managing items under the Invoicing section.
To successfully get company's items, users are required to furnish the relevant data within the request body, formatted in JSON. The body parameters integral to this request include:
code | string To search for items with that code |
type | string Enum: "Product" "Service" "Other" "ST" "TPC" To search for item of that type |
{- "response": "success",
- "message": {
- "Item": {
- "description": "Bananas from Madeira",
- "price": "12",
- "type": "Product",
- "unit": "Unit"
}
}
}
This segment provides comprehensive insights and guidelines on leveraging the invoicing capabilities of the Biziq API. Whether you’re initiating transactions, managing financial records, or enhancing your invoicing workflows, this section serves as your go-to resource. Endpoints for managing invoices under the Invoicing section.
To successfully get the invoicing summary, users are required to furnish the relevant data within the request body, formatted in JSON. The body parameters integral to this request include:
period | string Enum: "today" "week" "month" "between_dates" Period where the Summary takes place |
start_date | string <Y-m-d> Required if 'period' is 'between_dates', and defines the start date of the summary |
end_date | string <Y-m-d> Required if 'period' is 'between_dates', and defines the end date of the summary |
{- "response": "success",
- "message": {
- "invoice_count": "1",
- "invoice_vat_total": "2,50",
- "invoice_total": "12,50"
}
}
To successfully add a new invoice, users are required to furnish the relevant invoice data within the request body, formatted in JSON. The body parameters integral to this request include:
inv_date | string <Y-m-d> Default: "Today's date" Invoice Date |
currency | string Default: "€" Invoice currency |
due | string <Y-m-d> Invoice due date |
generateRefMB | boolean If you want to generate a MB Reference to the document (only available to invoices) |
is_receipt | string Default: "invoice" Type of document (“invoice” for invoices, “receipt” for invoice receipts, “simplified” for simplified invoices) |
paybylink | boolean If you want to generate a PayByLink link! |
payment_method | string The invoice payment method. If it exists it will use the existing one, if it is deactivated it will be activated and if it does not exist it will be created. |
tax_exemption | string Reason for exemption from fees |
recurrence | string Invoice recurrence |
remarks | string User notes |
retention | number Invoice retention |
send_to_client | boolean Whether the invoice was sent to the client |
showIban | boolean If you want to show Company's IBAN in the document (only available to invoices) |
status | string Default: "final" Invoice status (final or draft) |
required | object Client identification number group |
required | object List of invoice line items |
{- "response": "success",
- "message": {
- "document": {
- "invoice": {
- "document_id": "1",
- "name": "FT BETA/000001",
- "status": "final",
- "is_receipt": "invoice",
- "inv_date": "2024-01-01 00:00:00",
- "discount": "0.00000",
- "vat": "0.690000",
- "subtotal": "3.00000",
- "total": "3.690000"
}, - "client": {
- "name": "Jonh Doe",
- "address": "Street 21, n22",
- "city": "Porto",
- "country": "PT",
- "vat_number": "264107691"
}, - "channel": {
- "name": "Jonh Doe",
- "address": "Street 11, n29",
- "city": "Porto",
- "country": "PT"
}
}, - "document_sent": "Document sent.",
}
}
To successfully update a invoice, users are required to furnish the relevant invoice data within the request body, formatted in JSON. The body parameters integral to this request include:
document_id required | number Invoice identification |
inv_date | string <Y-m-d> Default: "Today's date" Invoice Date |
currency | string Default: "€" Invoice currency |
due | string <Y-m-d> Invoice due date |
generateRefMB | boolean If you want to generate a MB Reference to the document (only available to invoices) |
is_receipt | string Default: "invoice" Type of document (“invoice” for invoices, “receipt” for invoice receipts, “simplified” for simplified invoices) |
paybylink | boolean If you want to generate a PayByLink link! |
payment_method | string The invoice payment method. If it exists it will use the existing one, if it is deactivated it will be activated and if it does not exist it will be created. |
tax_exemption | string Reason for exemption from fees |
recurrence | string Invoice recurrence |
remarks | string User notes |
retention | number Invoice retention |
send_to_client | boolean Whether the invoice was sent to the client |
showIban | boolean If you want to show Company's IBAN in the document (only available to invoices) |
status | string Default: "final" Invoice status (final or draft) |
required | object List of invoice line items |
{- "response": "success",
- "message": {
- "document": {
- "invoice": {
- "document_id": "1",
- "name": "FT BETA/000001",
- "status": "final",
- "is_receipt": "invoice",
- "inv_date": "2024-01-01 00:00:00",
- "discount": "0.00000",
- "vat": "0.690000",
- "subtotal": "3.00000",
- "total": "3.690000"
}, - "client": {
- "name": "Jonh Doe",
- "address": "Street 21, n22",
- "city": "Porto",
- "country": "PT",
- "vat_number": "264107691"
}, - "channel": {
- "name": "Jonh Doe",
- "address": "Street 11, n29",
- "city": "Porto",
- "country": "PT"
}
}, - "document_sent": "Document sent.",
}
}
name | string Invoice Identification |
document_id | string Document Identification |
name required | string |
document_id | string |
{- "name": "string",
- "document_id": "string"
}
{- "response": "success",
- "message": {
- "document": {
- "invoice": {
- "name": "FT BETA/000001",
- "status": "final",
- "is_receipt": "invoice",
- "inv_date": "2024-01-01 00:00:00",
- "discount": "0.00000",
- "vat": "0.690000",
- "subtotal": "3.00000",
- "total": "3.690000"
}, - "client": {
- "name": "Jonh Doe",
- "address": "Street 21, n22",
- "city": "Porto",
- "country": "PT",
- "vat_number": "264107691"
}, - "channel": {
- "name": "Jonh Doe",
- "address": "Street 11, n29",
- "city": "Porto",
- "country": "PT"
}
}
}
}
name | string Document Identification |
document_id | string Document Identification |
status required | string Enum: "final" "canceled" "deleted" The status you want to put your Document |
cancelation_reason | string The reason why you want to cancel your Document |
name required | string |
document_id | string |
status required | string |
cancelation_reason | string |
{- "name": "string",
- "document_id": "string",
- "status": "string",
- "cancelation_reason": "string"
}
{- "response": "success",
- "message": "Your document was successfully finalized"
}
names required | Array of arrays Invoices Identification |
mail Email to send the Invoice, if not set the Invoice is sent to the clients email |
{- "response": "success",
- "message": {
- "document": {
- "name": "FT BETA/000001",
- "document_sent": true
}
}
}
To successfully import data to mass create invoices, users are required to furnish the relevant invoice data within the request body, formatted in JSON. The body parameters integral to this request include:
company_vat | integer company VAT number |
required | Array of objects This array can have multiple invoices to be created |
{- "response": "success",
- "bash_id": "8a005421-77ee-44d3-a84c-cceef66c11a3",
- "invalid": {
- "document": {
- "client": {
- "address": "Rua De So Joo, 90 2",
- "cid_external": "10792",
- "city": "Angra Do Herosmo",
- "country": "PT",
- "economic_area": "0",
- "name": "Sandra Sousa, Lda",
- "postal_code": "9700-182",
- "vat_number": "512047146"
}, - "inv_date": "2025-04-15",
- "invoicing_start_date": "2023-11-16 00:00:00",
- "invoicing_end_date": "2025-04-15 23:59:59",
- "is_receipt": "receipt",
- "line_items": [
- {
- "client_child": {
- "address": "Rua De So Joo, 90 2",
- "cid_external": "10792",
- "city": "Angra Do Herosmo",
- "economic_area": "0",
- "name": "Sandra Sousa, Lda",
- "postal_code": "9700-182",
- "vat": "512047146"
}, - "description": "Movimentos do dia 2025-04-08",
- "price": "1.40000",
- "vat": "16.00",
- "code": "COM01",
- "type": "Product",
- "qty": 1
}
], - "remarks": "",
- "currency": "EUR_€",
- "status": "final"
}, - "errors": {
- "line_items.0.vat": [
- "The selected line_items.0.vat is invalid."
]
}
}
}
hash | string Mass import hash |
page | int Page number for pagination |
{- "response": "success",
- "queued_count": 0,
- "done_count": 191,
- "data": {
- "current_page": 1,
- "data": [
- {
- "cid": null,
- "type": "receipt",
- "name": "FR BETAURATE-2025/000381",
- "date": "2025-06-03",
- "lines": "{\"client\":{\"address\":\"Rua Quinta do Bom Retiro, 9 Armazm 4, Vale Fetal\",\"cid_external\":\"13\",\"city\":\"Charneca da Caparica\",\"country\":\"PT\",\"economic_area\":\"0\",\"email\":\"[email protected]\",\"name\":\"Web roots - multimedia e publicidade lda\",\"postal_code\":\"2820-690\",\"vat_number\":\"508844525\"},\"inv_date\":\"2025-04-15\",\"invoicing_end_date\":\"2025-04-15 23:59:59\",\"invoicing_start_date\":\"2025-04-01 00:00:00\",\"is_receipt\":\"receipt\",\"line_items\":[{\"client_child\":{\"address\":\"Rua Quinta do Bom Retiro, 9 Armazm 4, Vale Fetal\",\"cid_external\":\"13\",\"city\":\"Charneca da Caparica\",\"economic_area\":\"0\",\"email\":\"[email protected]\",\"name\":\"Web roots - multimedia e publicidade lda\",\"postal_code\":\"2820-690\",\"vat\":\"508844525\"},\"description\":\"Movimentos do dia 2025-04-01\",\"price\":\"1.31000\",\"vat\":\"23.00\",\"code\":\"COM01\",\"type\":\"Product\",\"qty\":1}]}",
- "status": "done"
}
]
}
}
This segment provides comprehensive insights and guidelines on leveraging the invoicing capabilities of the Biziq API. Whether you’re initiating transactions, managing financial records, or enhancing your invoicing workflows, this section serves as your go-to resource. Endpoints for managing proformas under the Invoicing section.
To successfully add a new proforma, users are required to furnish the relevant invoice data within the request body, formatted in JSON. The body parameters integral to this request include:
date | string <Y-m-d> Default: "Today's date" Proforma Date |
currency | string Default: "€" Proforma currency |
due | string <Y-m-d> Proforma due date |
payment_method | string The proforma payment method. If it exists it will use the existing one, if it is deactivated it will be activated and if it does not exist it will be created. |
tax_exemption | string Reason for exemption from fees |
remarks | string User notes |
retention | number Proforma retention |
send_to_client | boolean Whether the proforma was sent to the client |
status | string Default: "final" Proforma status (final or draft) |
required | object Client identification number group |
required | object List of invoice line items |
{- "response": "success",
- "message": {
- "document": {
- "proforma": {
- "document_id": "1",
- "name": "PF BETA/000001",
- "status": "final",
- "inv_date": "2024-01-01 00:00:00",
- "discount": "0.00000",
- "vat": "0.690000",
- "subtotal": "3.00000",
- "total": "3.690000"
}, - "client": {
- "name": "Jonh Doe",
- "address": "Street 21, n22",
- "city": "Porto",
- "country": "PT",
- "vat_number": "264107691"
}, - "channel": {
- "name": "Jonh Doe",
- "address": "Street 11, n29",
- "city": "Porto",
- "country": "PT"
}
}, - "document_sent": "Document sent.",
}
}
To successfully update a Proforma, users are required to furnish the relevant invoice data within the request body, formatted in JSON. The body parameters integral to this request include:
document_id required | number Invoice identification |
date | string <Y-m-d> Default: "Today's date" Proforma Date |
currency | string Default: "€" Proforma currency |
due | string <Y-m-d> Proforma due date |
payment_method | string The proforma payment method. If it exists it will use the existing one, if it is deactivated it will be activated and if it does not exist it will be created. |
tax_exemption | string Reason for exemption from fees |
remarks | string User notes |
retention | number Proforma retention |
send_to_client | boolean Whether the proforma was sent to the client |
status | string Default: "final" Proforma status (final or draft) |
required | object List of invoice line items |
{- "response": "success",
- "message": {
- "document": {
- "proforma": {
- "document_id": "1",
- "name": "PF BETA/000001",
- "status": "final",
- "inv_date": "2024-01-01 00:00:00",
- "discount": "0.00000",
- "vat": "0.690000",
- "subtotal": "3.00000",
- "total": "3.690000"
}, - "client": {
- "name": "Jonh Doe",
- "address": "Street 21, n22",
- "city": "Porto",
- "country": "PT",
- "vat_number": "264107691"
}, - "channel": {
- "name": "Jonh Doe",
- "address": "Street 11, n29",
- "city": "Porto",
- "country": "PT"
}
}, - "document_sent": "Document sent.",
}
}
name | string Invoice Identification |
document_id | string Document Identification |
name required | string |
document_id | string |
{- "name": "string",
- "document_id": "string"
}
{- "response": "success",
- "message": {
- "document": {
- "invoice": {
- "name": "PF BETA/000001",
- "status": "final",
- "inv_date": "2024-01-01 00:00:00",
- "discount": "0.00000",
- "vat": "0.690000",
- "subtotal": "3.00000",
- "total": "3.690000"
}, - "client": {
- "name": "Jonh Doe",
- "address": "Street 21, n22",
- "city": "Porto",
- "country": "PT",
- "vat_number": "264107691"
}, - "channel": {
- "name": "Jonh Doe",
- "address": "Street 11, n29",
- "city": "Porto",
- "country": "PT"
}
}
}
}
name | string Document Identification |
document_id | string Document Identification |
status required | string Enum: "final" "canceled" "deleted" The status you want to put your Document |
cancelation_reason | string The reason why you want to cancel your Document |
name required | string |
document_id | string |
status required | string |
cancelation_reason | string |
{- "name": "string",
- "document_id": "string",
- "status": "string",
- "cancelation_reason": "string"
}
{- "response": "success",
- "message": "Your document was successfully finalized"
}
This segment provides comprehensive insights and guidelines on leveraging the invoicing capabilities of the Biziq API. Whether you’re initiating transactions, managing financial records, or enhancing your invoicing workflows, this section serves as your go-to resource. Endpoints for managing quotations under the Invoicing section.
To successfully add a new quotations, users are required to furnish the relevant invoice data within the request body, formatted in JSON. The body parameters integral to this request include:
date | string <Y-m-d> Default: "Today's date" Quotation Date |
currency | string Default: "€" Quotation currency |
due | string <Y-m-d> Quotation due date |
payment_method | string The quotation payment method. If it exists it will use the existing one, if it is deactivated it will be activated and if it does not exist it will be created. |
tax_exemption | string Reason for exemption from fees |
remarks | string User notes |
retention | number Quotation retention |
send_to_client | boolean Whether the quotation was sent to the client |
status | string Default: "final" Quotation status (final or draft) |
required | object Client identification number group |
required | object List of invoice line items |
{- "response": "success",
- "message": {
- "document": {
- "quotation": {
- "document_id": "1",
- "name": "OR BETA/000001",
- "status": "final",
- "inv_date": "2024-01-01 00:00:00",
- "discount": "0.00000",
- "vat": "0.690000",
- "subtotal": "3.00000",
- "total": "3.690000"
}, - "client": {
- "name": "Jonh Doe",
- "address": "Street 21, n22",
- "city": "Porto",
- "country": "PT",
- "vat_number": "264107691"
}, - "channel": {
- "name": "Jonh Doe",
- "address": "Street 11, n29",
- "city": "Porto",
- "country": "PT"
}
}, - "document_sent": "Document sent.",
}
}
To successfully update a Quotation, users are required to furnish the relevant invoice data within the request body, formatted in JSON. The body parameters integral to this request include:
document_id required | number Invoice identification |
date | string <Y-m-d> Default: "Today's date" Quotation Date |
currency | string Default: "€" Quotation currency |
due | string <Y-m-d> Quotation due date |
payment_method | string The quotation payment method. If it exists it will use the existing one, if it is deactivated it will be activated and if it does not exist it will be created. |
tax_exemption | string Reason for exemption from fees |
remarks | string User notes |
retention | number Quotation retention |
send_to_client | boolean Whether the quotation was sent to the client |
status | string Default: "final" Quotation status (final or draft) |
required | object List of invoice line items |
{- "response": "success",
- "message": {
- "document": {
- "quotation": {
- "document_id": "1",
- "name": "OR BETA/000001",
- "status": "final",
- "inv_date": "2024-01-01 00:00:00",
- "discount": "0.00000",
- "vat": "0.690000",
- "subtotal": "3.00000",
- "total": "3.690000"
}, - "client": {
- "name": "Jonh Doe",
- "address": "Street 21, n22",
- "city": "Porto",
- "country": "PT",
- "vat_number": "264107691"
}, - "channel": {
- "name": "Jonh Doe",
- "address": "Street 11, n29",
- "city": "Porto",
- "country": "PT"
}
}, - "document_sent": "Document sent.",
}
}
name | string Invoice Identification |
document_id | string Document Identification |
name required | string |
document_id | string |
{- "name": "string",
- "document_id": "string"
}
{- "response": "success",
- "message": {
- "document": {
- "document": {
- "name": "OR BETA/000001",
- "status": "final",
- "inv_date": "2024-01-01 00:00:00",
- "discount": "0.00000",
- "vat": "0.690000",
- "subtotal": "3.00000",
- "total": "3.690000"
}, - "client": {
- "name": "Jonh Doe",
- "address": "Street 21, n22",
- "city": "Porto",
- "country": "PT",
- "vat_number": "264107691"
}, - "channel": {
- "name": "Jonh Doe",
- "address": "Street 11, n29",
- "city": "Porto",
- "country": "PT"
}
}
}
}
name | string Document Identification |
document_id | string Document Identification |
status required | string Enum: "final" "canceled" "deleted" The status you want to put your Document |
cancelation_reason | string The reason why you want to cancel your Document |
name required | string |
document_id | string |
status required | string |
cancelation_reason | string |
{- "name": "string",
- "document_id": "string",
- "status": "string",
- "cancelation_reason": "string"
}
{- "response": "success",
- "message": "Your document was successfully finalized"
}
This segment provides comprehensive insights and guidelines on leveraging the invoicing capabilities of the Biziq API. Whether you’re initiating transactions, managing financial records, or enhancing your invoicing workflows, this section serves as your go-to resource. Endpoints for managing receipts under the Invoicing section.
To successfully add a new Receipt, users are required to furnish the relevant invoice data within the request body, formatted in JSON. The body parameters integral to this request include:
date | string <Y-m-d> Default: "Today's date" Receipt Date |
document_id | number Identifier of the invoice that is going to generate a Receipt |
name | string Identifier of the invoice that is going to generate a Receipt |
payment_date | string <Y-m-d> Default: "Today's date" The date when the payment occurred |
payment_method required | string Method used in the payment |
remarks | string User notes |
send_to_client | boolean Whether the transport guide was sent to the client |
status | string Default: "final" Transport Guide status (final or draft) |
date | string |
document_id | number |
name required | string |
payment_date | string |
payment_method required | string |
remarks | string |
send_to_client | boolean |
status | string |
{- "date": "string",
- "document_id": 0,
- "name": "string",
- "payment_date": "string",
- "payment_method": "string",
- "remarks": "string",
- "send_to_client": true,
- "status": "string"
}
{- "response": "success",
- "message": {
- "document": {
- "receipt": {
- "document_id": "1",
- "name": "RG BETA/000001",
- "status": "final",
- "inv_date": "2024-01-01 00:00:00",
- "discount": "0.00000",
- "vat": "0.690000",
- "subtotal": "3.00000",
- "total": "3.690000"
}, - "client": {
- "name": "Jonh Doe",
- "address": "Street 21, n22",
- "city": "Porto",
- "country": "PT",
- "vat_number": "264107691"
}, - "channel": {
- "name": "Jonh Doe",
- "address": "Street 11, n29",
- "city": "Porto",
- "country": "PT"
}
}, - "document_sent": "Document sent.",
}
}
name | string Invoice Identification |
document_id | string Document Identification |
name required | string |
document_id | string |
{- "name": "string",
- "document_id": "string"
}
{- "response": "success",
- "message": {
- "document": {
- "receipt": {
- "document_id": "1",
- "name": "RG BETA/000001",
- "status": "final",
- "inv_date": "2024-01-01 00:00:00",
- "discount": "0.00000",
- "vat": "0.690000",
- "subtotal": "3.00000",
- "total": "3.690000"
}, - "client": {
- "name": "Jonh Doe",
- "address": "Street 21, n22",
- "city": "Porto",
- "country": "PT",
- "vat_number": "264107691"
}, - "channel": {
- "name": "Jonh Doe",
- "address": "Street 11, n29",
- "city": "Porto",
- "country": "PT"
}
}
}
}
name | string Document Identification |
document_id | string Document Identification |
status required | string Enum: "final" "canceled" "deleted" The status you want to put your Document |
cancelation_reason | string The reason why you want to cancel your Document |
name required | string |
document_id | string |
status required | string |
cancelation_reason | string |
{- "name": "string",
- "document_id": "string",
- "status": "string",
- "cancelation_reason": "string"
}
{- "response": "success",
- "message": "Your document was successfully finalized"
}
This segment provides comprehensive insights and guidelines on leveraging the invoicing capabilities of the Biziq API. Whether you’re initiating transactions, managing financial records, or enhancing your invoicing workflows, this section serves as your go-to resource. Endpoints for managing transport guides under the Invoicing section.
To successfully add a new Transport Guide, users are required to furnish the relevant invoice data within the request body, formatted in JSON. The body parameters integral to this request include:
charge_date required | string <Y-m-d> Charge Date, also know as the date of the beggining of transport, must be equal or after today |
charge_hours required | number Charge Hours, also know as the hour of the beggining of transport |
charge_minutes required | number Charge Minutes, also know as the minute of the beggining of transport |
charge_address required | string Address of where the transport begins |
charge_city required | string City of where the transport begins |
charge_postal_code required | string Postal Code of where the transport begins |
charge_country required | string Country of where the transport begins |
date | string <Y-m-d> Default: "Today's date" Proforma Date |
currency | string Default: "€" Proforma currency |
delivery_address required | string Address of where the transport ends |
delivery_city required | string City of where the transport ends |
delivery_postal_code required | string Postal Code of where the transport ends |
delivery_country required | string Country of where the transport ends |
delivery_address required | string Address of where the transport ends |
tax_exemption | string Reason for exemption from fees |
remarks | string User notes |
registration | string Transport Vehicle licence plates |
send_to_client | boolean Whether the transport guide was sent to the client |
status | string Default: "final" Transport Guide status (final or draft) |
required | object Client identification number group |
required | object List of invoice line items |
{- "response": "success",
- "message": {
- "document": {
- "transport_guide": {
- "document_id": "1",
- "name": "GT BETA/000001",
- "status": "final",
- "inv_date": "2024-01-01 00:00:00",
- "discount": "0.00000",
- "vat": "0.690000",
- "subtotal": "3.00000",
- "total": "3.690000"
}, - "client": {
- "name": "Jonh Doe",
- "address": "Street 21, n22",
- "city": "Porto",
- "country": "PT",
- "vat_number": "264107691"
}, - "channel": {
- "name": "Jonh Doe",
- "address": "Street 11, n29",
- "city": "Porto",
- "country": "PT"
}
}, - "document_sent": "Document sent.",
}
}
To successfully update a Transport Guide, users are required to furnish the relevant invoice data within the request body, formatted in JSON. The body parameters integral to this request include:
document_id required | number Invoice identification |
charge_date required | string <Y-m-d> Charge Date, also know as the date of the beggining of transport, must be equal or after today |
charge_hours required | number Charge Hours, also know as the hour of the beggining of transport |
charge_minutes required | number Charge Minutes, also know as the minute of the beggining of transport |
charge_address required | string Address of where the transport begins |
charge_city required | string City of where the transport begins |
charge_postal_code required | string Postal Code of where the transport begins |
charge_country required | string Country of where the transport begins |
date | string <Y-m-d> Default: "Today's date" Proforma Date |
currency | string Default: "€" Proforma currency |
delivery_address required | string Address of where the transport ends |
delivery_city required | string City of where the transport ends |
delivery_postal_code required | string Postal Code of where the transport ends |
delivery_country required | string Country of where the transport ends |
delivery_address required | string Address of where the transport ends |
tax_exemption | string Reason for exemption from fees |
remarks | string User notes |
registration | string Transport Vehicle licence plates |
send_to_client | boolean Whether the transport guide was sent to the client |
status | string Default: "final" Transport Guide status (final or draft) |
required | object List of invoice line items |
{- "response": "success",
- "message": {
- "document": {
- "transport_guide": {
- "document_id": "1",
- "name": "FT BETA/000001",
- "status": "final",
- "inv_date": "2024-01-01 00:00:00",
- "discount": "0.00000",
- "vat": "0.690000",
- "subtotal": "3.00000",
- "total": "3.690000"
}, - "client": {
- "name": "Jonh Doe",
- "address": "Street 21, n22",
- "city": "Porto",
- "country": "PT",
- "vat_number": "264107691"
}, - "channel": {
- "name": "Jonh Doe",
- "address": "Street 11, n29",
- "city": "Porto",
- "country": "PT"
}
}, - "document_sent": "Document sent.",
}
}
name | string Invoice Identification |
document_id | string Document Identification |
name required | string |
document_id | string |
{- "name": "string",
- "document_id": "string"
}
{- "response": "success",
- "message": {
- "document": {
- "invoice": {
- "name": "PF BETA/000001",
- "status": "final",
- "inv_date": "2024-01-01 00:00:00",
- "discount": "0.00000",
- "vat": "0.690000",
- "subtotal": "3.00000",
- "total": "3.690000"
}, - "client": {
- "name": "Jonh Doe",
- "address": "Street 21, n22",
- "city": "Porto",
- "country": "PT",
- "vat_number": "264107691"
}, - "channel": {
- "name": "Jonh Doe",
- "address": "Street 11, n29",
- "city": "Porto",
- "country": "PT"
}
}
}
}
name | string Document Identification |
document_id | string Document Identification |
status required | string Enum: "final" "canceled" "deleted" The status you want to put your Document |
cancelation_reason | string The reason why you want to cancel your Document |
name required | string |
document_id | string |
status required | string |
cancelation_reason | string |
{- "name": "string",
- "document_id": "string",
- "status": "string",
- "cancelation_reason": "string"
}
{- "response": "success",
- "message": "Your document was successfully finalized"
}
This segment provides comprehensive insights and guidelines on leveraging the invoicing capabilities of the Biziq API. Whether you’re initiating transactions, managing financial records, or enhancing your invoicing workflows, this section serves as your go-to resource. Endpoints for managing SAFT under the Invoicing section.
start_date required | string <Y-m-d> Start Date, also know as the date of the beggining of the Billing Period, must be before End Date |
end_date required | string <Y-m-d> End Date, also know as the date of the conclusion of the Billing Period, must be after Start Date |
rebuild | boolean If you want to build a new XML file. |
{- "response": "success",
- "status": "finished",
}
This segment provides comprehensive insights and guidelines on leveraging the invoicing capabilities of the Biziq API. Whether you’re initiating transactions, managing financial records, or enhancing your invoicing workflows, this section serves as your go-to resource. Endpoints for managing series under the Invoicing section.
To successfully create a new Serie, users are required to furnish the relevant invoice data within the request body, formatted in JSON. The body parameters integral to this request include:
name required | string Series Name |
type | string Default: "invoice" Enum: "invoice" "invoice_simplified" "invoice_receipt" "transport_guide" "credit_note" "proforma" "quotation" "receipt" Type of document the series belongs to |
validation_code | string Only necessary if with dont have a communication wuth Tax Authority |
{- "response": "success",
- "message": {
- "serie": {
- "current_id": "1",
- "expire_date": "2024-12-31",
- "name": "1",
- "next_id": "2",
- "type": "invoice",
- "validation_code": "F23FM4GGBD"
}
}
}
type | string Default: "invoice" Enum: "invoice" "invoice_simplified" "invoice_receipt" "transport_guide" "credit_note" "proforma" "quotation" "receipt" Type of document the series belongs to |
{- "response": "success",
- "message": {
- "serie": {
- "current_id": "1",
- "expire_date": "2024-12-31",
- "name": "1",
- "next_id": "2",
- "type": "invoice",
- "validation_code": "F23FM4GGBD"
}
}
}
This segment outlines various requests that users can execute to effectively manage their SMS interactions within the Biziq platform.
In order to dispatch SMS messages, users must provide the necessary data within the request body, formatted in JSON. The essential body parameters for this request include:
message required | string The message that the user intends to send |
mobile_num | string Mobile number of the message recipient |
sender required | string Identification of the message sender |
sms_schedule | string Schedule for sending the message on a specified day and hour |
blk_Add | string Enables users to send the same message to multiple numbers |
mobile_num_blk | string Identifies the numbers to which the user wants to send a message, separated by commas |
template_Add | string Allows the addition of an SMS template |
template_name | string Name of the SMS template |
hh | string Additional hour information |
mm | string Additional month information |
{- "response": "success",
- "message": "SMS sent successfully."
}
This segment outlines various requests that users can execute to effectively manage their SMS interactions within the Biziq platform. Endpoints for managing Senders under the SMS section.
In order to create senders, users must provide the necessary data within the request body, formatted in JSON. The essential body parameters for this request include:
sender_name required | string The sender that the user intends to create |
unlimited | boolean Identifies whether the created sender has an unlimited expiration time |
expire_on | date Identification the expire date |
{- "response": "success",
- "message": "Sender create successfully."
}
This segment outlines various requests that users can execute to effectively manage their SMS interactions within the Biziq platform. Endpoints for managing Templates under the SMS section.
In order to create templates, users must provide the necessary data within the request body, formatted in JSON. The essential body parameters for this request include:
name required | string The name of the template that the user intends to create |
template required | string The template that the client intends to create |
{- "response": "success",
- "message": "Template create successfully."
}
This segment outlines various requests that users can execute to effectively manage their SMS interactions within the Biziq platform. Endpoints for managing Contacts under the SMS section.
In order to create contacts, users must provide the necessary data within the request body, formatted in JSON. The essential body parameters for this request include:
name required | string The name the user intends to add to the contact |
mobile_number required | string Mobile number of the contact |
mobile_code_contact required | string The country identifier used in the contact to be saved |
{- "response": "success",
- "message": "Contact successfully created."
}