Saltar al contingut principal
GET

Obtenir l'estoc en trànsit d'un producte

Scope:inventory:products.read
https://api.holded.com/api/v2/products/{productId}/stock/transit

Retorna l'estoc en trànsit d'un producte, incloent-hi els detalls de cada moviment per document. Cada moviment representa un document (comanda de compra, comanda de venda o ordre de producció) que afecta l'estoc en trànsit del producte.

Paràmetres

Paràmetres de ruta

productIdstringobligatori

ID del producte (ObjectId hexadecimal de 24 caràcters)

Petició

python
import requests

url = "https://api.holded.com/api/v2/products/{productId}/stock/transit"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json",
}

response = requests.get(url, headers=headers)
print(response.json())

Respostes

Resposta

json
{
  "product_id": "507f1f77bcf86cd799439011",
  "in_transit": "10",
  "compromised": "5",
  "movements": [
    {
      "document_id": "string",
      "document_type": "order",
      "movement_type": "compromise",
      "total": "10",
      "date": "2024-01-15T10:30:00Z",
      "variants": [
        {
          "variant_id": "...",
          "virtual": "...",
          "real": "...",
          "transit": "..."
        }
      ]
    }
  ]
}

Respostes exitoses

200Estoc en trànsit del producteapplication/json
object
product_idstringrequired

Unique identifier of the product

in_transitstringrequired

Net incoming stock (in transit minus compromised) as a decimal string

compromisedstringrequired

Stock committed to pending sales or production orders as a decimal string

movements[]object[]required

Document movements contributing to the transit totals

document_idstringrequired

Identifier of the source document

document_typestringrequired

Type of the source document (e.g. salesorder, order, productionorder)

movement_typestringrequired

Whether this movement is incoming or compromise

Enum:compromiseincoming
totalstringrequired

Total quantity of this movement as a decimal string

datestring<date-time>required

Date of the movement in ISO 8601 format

variants[]object[]required

Per-variant breakdown of the movement

Respostes d'error

401API key no vàlida o no proporcionadaapplication/json
403Permisos insuficientsapplication/json
404Producte no trobatapplication/json
429Límit de sol·licituds exceditapplication/json