Crear un pedido de compra
inventory:purchase-orders.writehttps://api.holded.com/api/v2/purchase-ordersCrea un nuevo pedido de compra para un proveedor.
Cuerpo de la petición
Identificador de un contacto existente
Nombre del contacto
Descripción en texto libre
Fecha de emisión en formato ISO 8601
Fecha de vencimiento en formato ISO 8601
Notas internas visibles solo para tu equipo
Si es true, una línea sin impuestos propios, no vinculada a un producto o servicio del catálogo, de un contacto sin impuestos por defecto, toma los impuestos por defecto de la cuenta: los de venta en un documento de venta y los de compra en uno de compra. Si es false o se omite, esa línea se crea sin impuestos
falseCódigo de idioma ISO 639-1
Código de moneda ISO 4217
Tipo de cambio
Líneas del documento
Nombre de la línea
Tipo de línea (product, service o title)
producttitleserviceDescripción de la línea
Identificador del producto vinculado
Identificador de la variante del producto vinculado. Requiere product_id
Identificador del servicio vinculado a esta línea
Cantidad de unidades
Precio unitario
Porcentaje de descuento aplicado a esta línea
Lista de identificadores de impuesto a aplicar
Referencia SKU del producto en esta línea
Código de cuenta contable de la línea
Identificador del proyecto vinculado a esta línea
Unidad de medida de la línea (ej. kg, units, litros)
Si es true, la línea es un suplido (gasto pagado en nombre del cliente, excluido de la base imponible)
Etiquetas para clasificar
Valores de campos personalizados
Identificador del campo personalizado
Valor almacenado en el campo personalizado
Número de documento personalizado (por ejemplo, la referencia de factura del proveedor)
Identificador del almacén
Porcentaje de descuento global
Petición
import requests
url = "https://api.holded.com/api/v2/purchase-orders"
headers = {
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
}
payload = {
"contact_id": "string",
"contact_name": "string",
"description": "string",
"date": "2026-01-15",
"due_date": "2026-01-31",
"notes": "string",
"default_taxes": false,
"language": "es",
"currency": "EUR",
"currency_change": 0,
"items": [
{
"name": "string",
"type": "product",
"description": "string",
"product_id": "string",
"variant_id": "string",
"service_id": "string",
"units": 0,
"price": 0,
"discount": 0,
"taxes": [
"s_iva_21"
],
"sku": "string",
"account": "string",
"project_id": "string",
"unit_type": "string",
"supplied": false
}
],
"tags": [
"string"
],
"custom_fields": [
{
"field": "string",
"value": "string"
}
],
"number": "string",
"warehouse_id": "string",
"discount": 0
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())Respuestas
Respuesta
{
"id": "507f1f77bcf86cd799439011"
}Respuestas exitosas
201Pedido de compra creadoapplication/jsonRespuestas de error
400Solicitud incorrectaapplication/json401API key inválida o no proporcionadaapplication/json403Permisos insuficientesapplication/json422Error de validaciónapplication/json429Límite de solicitudes excedidoapplication/json