Listado de tickets de venta: recibos de venta
sales:receipts.readhttps://api.holded.com/api/v2/sales-receiptsDevuelve una lista paginada de tickets de venta de tu cuenta.
Parámetros
Parámetros de consulta
integeropcional= 50Número máximo de tickets de venta a devolver por página. Por defecto 25, máximo 100
stringopcionalCursor opaco para paginación. Usa el valor devuelto en la respuesta anterior
stringopcionalFiltrar por identificador de contacto
stringopcionalFiltrar por estado del ticket de venta
"pending""completed""partial""cancelled""failed""overdue""outstanding"string<date-time>opcionalFiltrar por fecha de inicio en formato ISO 8601
string<date-time>opcionalFiltrar por fecha de fin en formato ISO 8601
stringopcionalCampo y dirección de ordenación
"date""-date""dueDate""-dueDate""total""-total"stringopcionalFiltrar por estado de aprobación. Usa "draft" para borradores y "approved" para documentos aprobados
"draft""approved"Petición
import requests
url = "https://api.holded.com/api/v2/sales-receipts?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())Respuestas
Respuesta
{
"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": "..."
}
],
"payment_method_id": "string",
"payments_total": "0",
"payments_pending": "121.00"
}
],
"has_more": false,
"cursor": "string"
}Respuestas exitosas
200Listado de tickets de ventaapplication/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
Identifier of the default payment method for this sales receipt
Total amount already paid, as a decimal string
Remaining amount to be paid, as a decimal string
Opaque cursor to pass as ?cursor= to fetch the next page. Null on the last page.
Respuestas de error
401API key inválida o no proporcionadaapplication/json403Permisos insuficientesapplication/json429Límite de solicitudes excedidoapplication/json