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 |
string <date>
User's birth date |
| name
required
|
string
User's name |
| email
required
|
string <email>
User's email |
| password
required
|
string
User's password |
| confirm_password
required
|
string
Must be equal to password |
| postal_code |
string
User's postal code |
{- "address": "Street 123",
- "city": "Porto",
- "birth_date": "1990-01-01",
- "name": "João Silva",
- "password": "senhaSegura123",
- "confirm_password": "senhaSegura123",
- "country": "Portugal"
}
{- "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 parameter 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 strings
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 |
{- "ask_access": true,
- "address": "Praça Artur Santos Silva 74",
- "city": "Porto",
- "conservatory": "Conservatoria Registo Civil do Porto",
- "company_type": "SA",
- "country": "Portugal",
- "name": "Intelidus",
- "new_services": true,
- "services": [
- "accounting",
- "legal",
- "payroll"
], - "share_capital": 1000,
- "postal_code": "4200-534",
- "vat_number": "999111000"
}
{- "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 city |
| business_email
required
|
string
Company's email |
| postal_code
required
|
string
Company's address postal code |
{- "city": "Lisboa",
- "postal_code": "1000-123"
}
{- "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 |
{- "name": "John Doe"
}
{- "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 <date>
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) |
{- "date": "2025-06-25",
- "name": "FT BETA/000001",
- "serie": "Serie A",
- "reason": "Refund",
- "line_items": {
- "code": "A001",
- "qty": "10",
- "price": "100.00"
}
}
{- "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": "NC BETA/000001"
}
{- "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
required
|
string
|
| document_id |
string
|
| status
required
|
string
|
| cancelation_reason |
string
|
{- "name": "NC BETA/000001",
- "status": "canceled",
- "cancelation_reason": "Client requested cancellation"
}
{- "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 |
{- "code": "ITEM123"
}
{- "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' |
| end_date |
string <Y-m-d>
Required if 'period' is 'between_dates' |
{- "period": "month"
}
{- "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, receipt, simplified) |
| paybylink |
boolean
If you want to generate a PayByLink link! |
| payment_method |
string
The invoice payment method |
| 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 |
| status |
string
Default: "final"
Invoice status (final or draft) |
|
required
|
object
Client identification number group |
|
required
|
Array of objects
List of invoice line items |
{- "inv_date": "2025-06-25",
- "currency": "€",
- "due": "2025-07-25",
- "generateRefMB": true,
- "is_receipt": "invoice",
- "paybylink": false,
- "payment_method": "credit_card",
- "tax_exemption": null,
- "recurrence": "monthly",
- "remarks": "Cliente VIP, pagamento antecipado.",
- "retention": 3,
- "send_to_client": true,
- "showIban": true,
- "status": "final",
- "client": {
- "vat_number": 123456789,
- "name": "Empresa Exemplo Lda",
- "country": "PT",
- "address": "Rua das Flores, 123",
- "city": "Lisboa",
- "postal_code": "1000-100"
}, - "line_items": [
- {
- "code": "A100",
- "description": "Tech Consulting",
- "discount": "5",
- "qty": "10",
- "price": "100.00",
- "type": "service",
- "unit": "hour",
- "vat": "23"
}, - {
- "code": "B200",
- "description": "Software License",
- "discount": "0",
- "qty": "1",
- "price": "500.00",
- "type": "product",
- "unit": "unit",
- "vat": "23"
}
]
}
{- "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:
| inv_date |
string <date>
Invoice Date |
| currency |
string
Invoice currency |
| due |
string <date>
Invoice due date |
| generateRefMB |
boolean
Generate MB reference |
| is_receipt |
string
Enum: "invoice" "receipt" "simplified"
Document type |
| paybylink |
boolean
Generate PayByLink |
| payment_method |
string
Invoice payment method |
| tax_exemption |
string
Reason for tax exemption |
| recurrence |
string
Invoice recurrence |
| remarks |
string
Notes |
| retention |
number
Invoice retention |
| send_to_client |
boolean
Send to client |
| showIban |
boolean
Show IBAN on document |
| status |
string
Enum: "final" "draft"
Document status |
|
required
|
Array of objects
List of invoice line items |
{- "document_id": 1,
- "inv_date": "2025-06-25",
- "currency": "€",
- "due": "2025-07-25",
- "generateRefMB": true,
- "is_receipt": "invoice",
- "paybylink": true,
- "payment_method": "transfer",
- "tax_exemption": "M01",
- "recurrence": "monthly",
- "remarks": "Atualização do documento conforme pedido do cliente.",
- "retention": 4.5,
- "send_to_client": true,
- "showIban": true,
- "status": "final",
- "line_items": [
- {
- "code": "A100",
- "description": "Tech Consulting",
- "discount": "5%",
- "qty": "10",
- "price": "100.00",
- "type": "service",
- "unit": "hour",
- "vat": "23"
}, - {
- "code": "B200",
- "description": "Software License",
- "discount": "0%",
- "qty": "1",
- "price": "500.00",
- "type": "product",
- "unit": "unit",
- "vat": "23"
}
]
}
{- "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": "FT BETA/000001"
}
{- "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
required
|
string
|
| document_id |
string
|
| status
required
|
string
|
| cancelation_reason |
string
|
{- "name": "FT BETA/000001",
- "status": "canceled",
- "cancelation_reason": "Client requested cancellation"
}
{- "response": "success",
- "message": "Your document was successfully finalized"
}
| names
required
|
Array of strings
List of invoice names to send |
|
string <email>
Email to send the Invoice. If not set, it will be sent to the client’s email |
{- "names": [
- "FT BETA/000003"
], - "mail": "[email protected]"
}
{- "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."
]
}
}
}
Returns the status of a mass import operation, including pagination and processing results.
| hash
required
|
string
Mass import hash |
| page |
integer >= 1
Default: 1
Page number for pagination |
{- "hash": "abc123xyz",
- "page": 1
}
{- "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\"}}",
- "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
|
Array of objects
List of proforma line items |
{- "date": "2025-06-25",
- "currency": "€",
- "due": "2025-07-25",
- "payment_method": "credit_card",
- "tax_exemption": null,
- "remarks": "Cliente VIP, pagamento antecipado.",
- "retention": 3,
- "status": "final",
- "client": {
- "vat_number": 123456789,
- "name": "Empresa Exemplo Lda",
- "country": "PT",
- "address": "Rua das Flores, 123",
- "city": "Lisboa",
- "postal_code": "1000-100"
}, - "line_items": [
- {
- "code": "A100",
- "description": "Tech Consulting",
- "discount": "5",
- "qty": "10",
- "price": "100.00",
- "type": "service",
- "unit": "hour",
- "vat": "23"
}, - {
- "code": "B200",
- "description": "Software License",
- "discount": "0",
- "qty": "1",
- "price": "500.00",
- "type": "product",
- "unit": "unit",
- "vat": "23"
}
]
}
{- "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
Proforma 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
|
Array of objects
List of proforma line items |
{- "document_id": 1,
- "date": "2025-06-25",
- "currency": "€",
- "due": "2025-07-25",
- "payment_method": "credit_card",
- "tax_exemption": null,
- "remarks": "Cliente VIP, pagamento antecipado.",
- "retention": 3,
- "status": "final",
- "client": {
- "vat_number": 123456789,
- "name": "Empresa Exemplo Lda",
- "country": "PT",
- "address": "Rua das Flores, 123",
- "city": "Lisboa",
- "postal_code": "1000-100"
}, - "line_items": [
- {
- "code": "A100",
- "description": "Tech Consulting",
- "discount": "5",
- "qty": "10",
- "price": "100.00",
- "type": "service",
- "unit": "hour",
- "vat": "23"
}, - {
- "code": "B200",
- "description": "Software License",
- "discount": "0",
- "qty": "1",
- "price": "500.00",
- "type": "product",
- "unit": "unit",
- "vat": "23"
}
]
}
{- "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": "PF BETA/000001"
}
{- "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
required
|
string
|
| document_id |
string
|
| status
required
|
string
|
| cancelation_reason |
string
|
{- "name": "PF BETA/000001",
- "status": "canceled",
- "cancelation_reason": "Client requested cancellation"
}
{- "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
|
Array of objects
List of proforma line items |
{- "date": "2025-06-25",
- "currency": "€",
- "due": "2025-07-25",
- "payment_method": "credit_card",
- "tax_exemption": null,
- "remarks": "Cliente VIP, pagamento antecipado.",
- "retention": 3,
- "status": "final",
- "client": {
- "vat_number": 123456789,
- "name": "Empresa Exemplo Lda",
- "country": "PT",
- "address": "Rua das Flores, 123",
- "city": "Lisboa",
- "postal_code": "1000-100"
}, - "line_items": [
- {
- "code": "A100",
- "description": "Tech Consulting",
- "discount": "5",
- "qty": "10",
- "price": "100.00",
- "type": "service",
- "unit": "hour",
- "vat": "23"
}, - {
- "code": "B200",
- "description": "Software License",
- "discount": "0",
- "qty": "1",
- "price": "500.00",
- "type": "product",
- "unit": "unit",
- "vat": "23"
}
]
}
{- "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 |
| document_id
required
|
number
Quotation 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
|
Array of objects
List of Quotation line items |
{- "document_id": 1,
- "date": "2025-06-25",
- "currency": "€",
- "due": "2025-07-25",
- "payment_method": "credit_card",
- "tax_exemption": null,
- "remarks": "Cliente VIP, pagamento antecipado.",
- "retention": 3,
- "status": "final",
- "client": {
- "vat_number": 123456789,
- "name": "Empresa Exemplo Lda",
- "country": "PT",
- "address": "Rua das Flores, 123",
- "city": "Lisboa",
- "postal_code": "1000-100"
}, - "line_items": [
- {
- "code": "A100",
- "description": "Tech Consulting",
- "discount": "5",
- "qty": "10",
- "price": "100.00",
- "type": "service",
- "unit": "hour",
- "vat": "23"
}, - {
- "code": "B200",
- "description": "Software License",
- "discount": "0",
- "qty": "1",
- "price": "500.00",
- "type": "product",
- "unit": "unit",
- "vat": "23"
}
]
}
{- "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": "OR BETA/000001"
}
{- "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
required
|
string
|
| document_id |
string
|
| status
required
|
string
|
| cancelation_reason |
string
|
{- "name": "OR BETA/000001",
- "status": "canceled",
- "cancelation_reason": "Client requested cancellation"
}
{- "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
required
|
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 receipt was sent to the client |
| status |
string
Default: "final"
Receipt status (final or draft) |
{- "date": "2025-06-25",
- "document_id": 12345,
- "name": "FT BETA/000001",
- "payment_date": "2025-06-25",
- "payment_method": "Credit Card",
- "remarks": "Pagamento parcial da fatura",
- "send_to_client": true,
- "status": "final"
}
{- "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": "RG BETA/000001"
}
{- "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
required
|
string
|
| document_id |
string
|
| status
required
|
string
|
| cancelation_reason |
string
|
{- "name": "RG BETA/000001",
- "status": "canceled",
- "cancelation_reason": "Client requested cancellation"
}
{- "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_country
required
|
string
Country 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 |
| date |
string <Y-m-d>
Default: "Today's date"
Transport Guide Date |
| currency |
string
Default: "€"
Transport Guide currency |
| delivery_address
required
|
string
Address of where the transport ends |
| delivery_country
required
|
string
Country 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 |
| 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
|
Array of objects
List of proforma line items |
{- "charge_date": "2025-06-25",
- "charge_hours": 10,
- "charge_minutes": 10,
- "charge_address": "Street 101",
- "charge_country": "PT",
- "charge_city": "Lisbon",
- "charge_postal_code": "1234-213",
- "delivery_address": "Street 202",
- "delivery_country": "PT",
- "delivery_city": "Lisbon",
- "delivery_postal_code": "9876-543",
- "date": "2025-06-25",
- "currency": "€",
- "due": "2025-07-25",
- "payment_method": "credit_card",
- "tax_exemption": null,
- "remarks": "Cliente VIP, pagamento antecipado.",
- "retention": 3,
- "status": "final",
- "client": {
- "vat_number": 123456789,
- "name": "Empresa Exemplo Lda",
- "country": "PT",
- "address": "Rua das Flores, 123",
- "city": "Lisboa",
- "postal_code": "1000-100"
}, - "line_items": [
- {
- "code": "A100",
- "description": "Tech Consulting",
- "discount": "5",
- "qty": "10",
- "price": "100.00",
- "type": "service",
- "unit": "hour",
- "vat": "23"
}, - {
- "code": "B200",
- "description": "Software License",
- "discount": "0",
- "qty": "1",
- "price": "500.00",
- "type": "product",
- "unit": "unit",
- "vat": "23"
}
]
}
{- "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
|
string
Quotation 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_country
required
|
string
Country 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 |
| date |
string <Y-m-d>
Default: "Today's date"
Transport Guide Date |
| currency |
string
Default: "€"
Transport Guide currency |
| delivery_address
required
|
string
Address of where the transport ends |
| delivery_country
required
|
string
Country 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 |
| 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
|
Array of objects
List of proforma line items |
{- "document_id": 1,
- "charge_date": "2025-06-25",
- "charge_hours": 10,
- "charge_minutes": 10,
- "charge_address": "Street 101",
- "charge_country": "PT",
- "charge_city": "Lisbon",
- "charge_postal_code": "1234-213",
- "delivery_address": "Street 202",
- "delivery_country": "PT",
- "delivery_city": "Lisbon",
- "delivery_postal_code": "9876-543",
- "date": "2025-06-25",
- "currency": "€",
- "due": "2025-07-25",
- "payment_method": "credit_card",
- "tax_exemption": null,
- "remarks": "Cliente VIP, pagamento antecipado.",
- "retention": 3,
- "status": "final",
- "line_items": [
- {
- "code": "A100",
- "description": "Tech Consulting",
- "discount": "5",
- "qty": "10",
- "price": "100.00",
- "type": "service",
- "unit": "hour",
- "vat": "23"
}, - {
- "code": "B200",
- "description": "Software License",
- "discount": "0",
- "qty": "1",
- "price": "500.00",
- "type": "product",
- "unit": "unit",
- "vat": "23"
}
]
}
{- "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": "GT BETA/000001"
}
{- "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
required
|
string
|
| document_id |
string
|
| status
required
|
string
|
| cancelation_reason |
string
|
{- "name": "GT BETA/000001",
- "status": "canceled",
- "cancelation_reason": "Client requested cancellation"
}
{- "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. |
{- "start_date": "2025-01-01",
- "end_date": "2025-01-31",
- "rebuild": true
}
{- "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 we don't have communication with Tax Authority |
{- "name": "A001",
- "type": "invoice",
- "validation_code": "F23FM4GGBD"
}
{- "response": "success",
- "message": {
- "serie": {
- "current_id": "1",
- "expire_date": "2024-12-31",
- "name": "1",
- "next_id": "2",
- "type": "invoice",
- "validation_code": "F23FM4GGBD"
}
}
}
Type of document the series belongs to
| 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
Validation Code of the Serie |
{- "type": "invoice",
- "validation_code": "string"
}
{- "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 |
| mobile_code |
string
Indicates the mobile number code relative to the country |
| sender
required
|
string
Identification of the message sender |
| sms_schedule |
string
Schedule for sending the message on a specified day and hour (ISO 8601 format) |
| blk_Add |
string
Enables users to send the same message to multiple numbers |
| mobile_num_blk |
string
Comma-separated list of numbers to send the message to |
| 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 minute information |
{- "message": "Hi.",
- "mobile_num": "912345678",
- "sender": "MyCompany"
}
{- "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 |
string <date>
Expiration date of the sender in format YYYY-MM-DD |
{- "sender_name": "MyCompanySMS",
- "unlimited": false,
- "expire_on": "2025-12-31"
}
{- "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 |
| name
required
|
string
The name of the template that the user intends to create |
| template
required
|
string
The template content that the client intends to create |
{- "name": "Summer Promotion",
- "template": "Hi, enjoy summer promotion with us! Get 20% off on all products. Use code SUMMER20 at checkout."
}
{- "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 |
{- "name": "João Silva",
- "mobile_number": "999998888",
- "mobile_code_contact": "55"
}
{- "response": "success",
- "message": "Contact successfully created."
}