Saltar al contenido principal
POST

Crear un pedido de compra

Scope:inventory:purchase-orders.write
https://api.holded.com/api/v2/purchase-orders

Crea un nuevo pedido de compra para un proveedor.

Cuerpo de la petición

object
contact_idstringrequired

Identificador de un contacto existente

contact_namestringoptional

Nombre del contacto

descriptionstring | nulloptional

Descripción en texto libre

datestring<date>optional

Fecha de emisión en formato ISO 8601

due_datestring<date> | nulloptional

Fecha de vencimiento en formato ISO 8601

notesstring | nulloptional

Notas internas visibles solo para tu equipo

default_taxesbooleanoptional

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

default: false
languagestring | nulloptional

Código de idioma ISO 639-1

currencystring | nulloptional

Código de moneda ISO 4217

currency_changenumber<float> | nulloptional

Tipo de cambio

items[]object[]required

Líneas del documento

namestring

Nombre de la línea

typestring | null

Tipo de línea (product, service o title)

Enum:producttitleservice
descriptionstring | null

Descripción de la línea

product_idstring | null

Identificador del producto vinculado

variant_idstring | null

Identificador de la variante del producto vinculado. Requiere product_id

service_idstring | null

Identificador del servicio vinculado a esta línea

unitsnumber | null

Cantidad de unidades

pricenumber | null

Precio unitario

discountnumber | null

Porcentaje de descuento aplicado a esta línea

taxes[]string[] | null

Lista de identificadores de impuesto a aplicar

skustring | null

Referencia SKU del producto en esta línea

accountstring | null

Código de cuenta contable de la línea

project_idstring | null

Identificador del proyecto vinculado a esta línea

unit_typestring | null

Unidad de medida de la línea (ej. kg, units, litros)

suppliedboolean | null

Si es true, la línea es un suplido (gasto pagado en nombre del cliente, excluido de la base imponible)

tags[]string[]optional

Etiquetas para clasificar

custom_fields[]object[]optional

Valores de campos personalizados

fieldstring

Identificador del campo personalizado

valuestring

Valor almacenado en el campo personalizado

numberstring | nulloptional

Número de documento personalizado (por ejemplo, la referencia de factura del proveedor)

warehouse_idstring | nulloptional

Identificador del almacén

discountnumber | nulloptional

Porcentaje de descuento global

Petición

python
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

json
{
  "id": "507f1f77bcf86cd799439011"
}

Respuestas exitosas

201Pedido de compra creadoapplication/json
object
idstring

Respuestas de error

400Solicitud incorrectaapplication/json
401API key inválida o no proporcionadaapplication/json
403Permisos insuficientesapplication/json
422Error de validaciónapplication/json
429Límite de solicitudes excedidoapplication/json