Saltar al contenido principal
POST

Crear una orden de producción

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

Crea una nueva orden de producción. Requiere al menos el producto fabricado.

Cuerpo de la petición

object
descriptionstringoptional

Descripción en texto libre

datestring<date>optional

Fecha de emisión en formato ISO 8601

due_datestring<date>optional

Fecha de vencimiento en formato ISO 8601

contact_idstringoptional

Identificador de un contacto existente

contact_namestringoptional

Nombre del contacto

supplier_idstringoptional

Identificador de un proveedor existente

supplier_namestringoptional

Nombre del proveedor

notesstringoptional

Notas internas

currencystringoptional

Código de moneda ISO 4217

languagestringoptional

Código de idioma ISO 639-1

tags[]string[]optional

Etiquetas para clasificar

source_warehouse_idstringoptional

Identificador del almacén de origen

destination_warehouse_idstringoptional

Identificador del almacén de destino

manufacturing_pipeline_idstringoptional

Identificador del pipeline de fabricación

manufactured_productobjectrequired

Producto fabricado

product_idstringrequired

Identificador del producto a fabricar

namestringrequired

Nombre del producto fabricado

skustringoptional

SKU del producto fabricado

kindstringoptional

Tipo de producto (simple, variants, lots, serialnumbers)

Enum:simplelotspackvariantsserialnumbers
quantitynumberoptional

Cantidad a fabricar

variant_ids[]object[]optional

Variantes del producto fabricado

materials[]object[]optional

Materiales necesarios

namestring

Nombre del material

descriptionstring

Descripción del material

typestring

Tipo de línea (product, service, line)

Enum:productserviceline
kindstring

Tipo de producto del material (simple, lots, variants, serialnumbers, pack)

Enum:simplelotsvariantsserialnumberspack
product_idstring | null

Identificador del producto material

unitsnumber

Cantidad de unidades

pricenumber

Precio unitario

skustring

Código SKU

barcodestring

Código de barras

factory_codestring

Código de fábrica

secondary_ids[]object[]

Identificadores secundarios del material. Obligatorio cuando "type" es "product" (valor por defecto). Debe contener exactamente 1 elemento salvo que "kind" sea "lots" o "serialnumbers", y la suma de "units" debe igualar las "units" del material

is_valuedbooleanoptional

Orden valorada

Petición

python
import requests

url = "https://api.holded.com/api/v2/production-orders"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

payload = {
    "description": "string",
    "date": "2024-01-15",
    "due_date": "2024-02-15",
    "contact_id": "string",
    "contact_name": "string",
    "supplier_id": "string",
    "supplier_name": "string",
    "notes": "string",
    "currency": "string",
    "language": "string",
    "tags": [
        "string"
    ],
    "source_warehouse_id": "string",
    "destination_warehouse_id": "string",
    "manufacturing_pipeline_id": "string",
    "manufactured_product": {
        "product_id": "string",
        "name": "string",
        "sku": "string",
        "kind": [
            "simple",
            "lots",
            "pack",
            "variants",
            "serialnumbers"
        ],
        "quantity": 0,
        "variant_ids": [
            {
                "id": "string",
                "units": 0
            }
        ]
    },
    "materials": [
        {
            "name": "string",
            "description": "string",
            "type": "product",
            "kind": "simple",
            "product_id": "string",
            "units": 0,
            "price": 0,
            "sku": "string",
            "barcode": "string",
            "factory_code": "string",
            "secondary_ids": [
                {
                    "id": "...",
                    "units": "...",
                    "sku": "..."
                }
            ]
        }
    ],
    "is_valued": false
}
response = requests.post(url, headers=headers, json=payload)
print(response.json())

Respuestas

Respuesta

json
{
  "id": "507f1f77bcf86cd799439011"
}

Respuestas exitosas

201Orden de producción creadaapplication/json
object
idstring

Respuestas de error

400Solicitud incorrecta
401API key inválida o no proporcionadaapplication/json
403Permisos insuficientesapplication/json
429Límite de solicitudes excedidoapplication/json