Llistat d'albarans de compra
inventory:purchase-shipments.readhttps://api.holded.com/api/v2/purchase-shipmentsRetorna una llista paginada d'albarans de compra del teu compte.
Paràmetres
Paràmetres de consulta
integeropcional= 50Nombre màxim d'albarans de compra a retornar per pàgina. Per defecte 50, màxim 1000
stringopcionalCursor opac per a la paginació. Utilitza el valor retornat a la resposta anterior
stringopcionalFiltrar per identificador de contacte (proveïdor)
stringopcionalFiltrar per estat
"pending""completed""partial""cancelled""failed""overdue""outstanding"string<date-time>opcionalFiltrar albarans de compra emesos en aquesta data o posterior
string<date-time>opcionalFiltrar albarans de compra emesos en aquesta data o anterior
stringopcionalOrdre de classificació dels resultats. Prefixa amb - per a ordre descendent
"date""-date""dueDate""-dueDate""total""-total"Petició
import requests
url = "https://api.holded.com/api/v2/purchase-shipments?limit=50&cursor=value&contact_id=value"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
response = requests.get(url, headers=headers)
print(response.json())Respostes
Resposta
{
"items": [
{
"id": "507f1f77bcf86cd799439011",
"document_number": "INV-0001",
"contact_id": "507f1f77bcf86cd799439011",
"contact_name": "Acme Corp",
"description": "string",
"date": "2024-01-15",
"due_date": "2024-02-15",
"subtotal": "100.00",
"discount": "0",
"total": "121.00",
"tax": "21.00",
"currency": "EUR",
"status": "pending",
"tags": [
"string"
],
"lines": [
{
"line_id": "...",
"name": "...",
"description": "...",
"price": "...",
"units": "...",
"discount": "...",
"tax": "...",
"taxes": "...",
"tags": "...",
"product_id": "...",
"variant_id": "...",
"service_id": "...",
"sku": "...",
"weight": "...",
"cost_price": "...",
"account": "...",
"project_id": "...",
"retention": "...",
"unit_type": "...",
"supplied": "..."
}
]
}
],
"has_more": false,
"cursor": "string"
}Respostes exitoses
200Llistat d'albarans de compraapplication/jsonUnique identifier of the document
Sequential number assigned to the document
Identifier of the contact associated with this document
Name of the contact associated with this document
Free-text description of the document
Issue date of the document in ISO 8601 format
Payment due date in ISO 8601 format
Sum of all line amounts before tax and discounts, as a decimal string
Total discount applied to the document, as a decimal string
Final amount including taxes and discounts, as a decimal string
Total tax amount, as a decimal string
ISO 4217 currency code
Current status of the document
failedcompletedpendingpartialcancelledList of tags attached to the document
Line items included in the document
Opaque cursor to pass as ?cursor= to fetch the next page. Null on the last page.
Respostes d'error
401API key no vàlida o no proporcionadaapplication/json403Permisos insuficientsapplication/json429Límit de sol·licituds exceditapplication/json