Labels and documents

curl -X GET https://api-commerce.nucleoplatform.com/api/fulfillment/v1/orders/1042/labels \
  -H "Authorization: Bearer $NUCLEO_ACCESS_TOKEN" \
  -H 'Accept: application/json'

const res = await fetch("https://api-commerce.nucleoplatform.com/api/fulfillment/v1/orders/1042/labels", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.NUCLEO_ACCESS_TOKEN}`,
    Accept: "application/json",
  },
});
const data = await res.json();
console.log(res.status, data);

<?php

require 'vendor/autoload.php';

$client = new GuzzleHttp\Client();

$response = $client->request('GET', 'https://api-commerce.nucleoplatform.com/api/fulfillment/v1/orders/1042/labels', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('NUCLEO_ACCESS_TOKEN'),
        'Accept' => 'application/json',
    ],
    'http_errors' => false,
]);

echo $response->getStatusCode(), PHP_EOL;
echo $response->getBody();

{
  "data": [
    {
      "parcel": 1,
      "status": "ready",
      "carrier_code": "EXAMPLE",
      "carrier_name": "Example Express",
      "tracking_number": "1234567890",
      "format": "pdf",
      "content_type": "application/pdf",
      "content_base64": "JVBERi0xLjQKJcfsj6IKNSAwIG9iago8PC9MZW5ndGggNiAwIFI+PgpzdHJlYW0K"
    }
  ]
}

{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key.",
    "request_id": "0b6c3e4f-1a2d-4c5b-8e7f-9a0b1c2d3e4f"
  }
}

{
  "error": {
    "code": "connection_paused",
    "message": "This connection is paused: nothing was changed.",
    "request_id": "3c2b1a0f-9e8d-4c7b-a6f5-4e3d2c1b0a9f"
  }
}

{
  "error": {
    "code": "order_not_found",
    "message": "Order 1042 not found.",
    "request_id": "6d5c4b3a-2f1e-4d0c-9b8a-7f6e5d4c3b2a"
  }
}

{
  "error": {
    "code": "unknown_item",
    "message": "Some lines do not match an item of this order assigned to your warehouse. Nothing was changed.",
    "request_id": "2e1d0c9b-8a7f-4e6d-9c5b-4a3f2e1d0c9b",
    "details": {
      "lines.1": [
        "Not an item of this order assigned to your warehouse."
      ]
    }
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: retry after the number of seconds in Retry-After.",
    "request_id": "4f3e2d1c-0b9a-4f8e-8d7c-6b5a4f3e2d1c"
  }
}

curl -X POST https://api-commerce.nucleoplatform.com/api/fulfillment/v1/orders/1042/labels \
  -H "Authorization: Bearer $NUCLEO_ACCESS_TOKEN" \
  -H 'Idempotency-Key: 2f0c9a1e-6b4d-4f3a-9e7c-5d1b8a2c4e6f' \
  -H 'Content-Type: application/json' \
  -d '{
  "parcels": 2
}'

const res = await fetch("https://api-commerce.nucleoplatform.com/api/fulfillment/v1/orders/1042/labels", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.NUCLEO_ACCESS_TOKEN}`,
    "Idempotency-Key": "2f0c9a1e-6b4d-4f3a-9e7c-5d1b8a2c4e6f",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "parcels": 2
  }),
});
const data = await res.json();
console.log(res.status, data);

<?php

require 'vendor/autoload.php';

$client = new GuzzleHttp\Client();

$response = $client->request('POST', 'https://api-commerce.nucleoplatform.com/api/fulfillment/v1/orders/1042/labels', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('NUCLEO_ACCESS_TOKEN'),
        'Idempotency-Key' => '2f0c9a1e-6b4d-4f3a-9e7c-5d1b8a2c4e6f',
    ],
    'json' => [
        'parcels' => 2,
    ],
    'http_errors' => false,
]);

echo $response->getStatusCode(), PHP_EOL;
echo $response->getBody();

{
  "data": [
    {
      "parcel": 1,
      "status": "ready",
      "carrier_code": "string",
      "carrier_name": "string",
      "tracking_number": "string",
      "format": "pdf",
      "content_type": "application/pdf",
      "content_base64": "string"
    }
  ]
}

{
  "error": {
    "code": "validation_failed",
    "message": "The request is not valid.",
    "request_id": "1f7e3c2a-9b8d-4e6f-a5c4-3b2a1d0e9f8c",
    "details": {
      "lines.0.quantity": [
        "The lines.0.quantity field must be at least 0."
      ],
      "reason_code": [
        "The reason code field is required."
      ]
    }
  }
}

{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key.",
    "request_id": "0b6c3e4f-1a2d-4c5b-8e7f-9a0b1c2d3e4f"
  }
}

{
  "error": {
    "code": "connection_paused",
    "message": "This connection is paused: nothing was changed.",
    "request_id": "3c2b1a0f-9e8d-4c7b-a6f5-4e3d2c1b0a9f"
  }
}

{
  "error": {
    "code": "order_not_found",
    "message": "Order 1042 not found.",
    "request_id": "6d5c4b3a-2f1e-4d0c-9b8a-7f6e5d4c3b2a"
  }
}

{
  "error": {
    "code": "order_not_accepted",
    "message": "Accept order",
    "request_id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d"
  }
}

{
  "error": {
    "code": "unknown_item",
    "message": "Some lines do not match an item of this order assigned to your warehouse. Nothing was changed.",
    "request_id": "2e1d0c9b-8a7f-4e6d-9c5b-4a3f2e1d0c9b",
    "details": {
      "lines.1": [
        "Not an item of this order assigned to your warehouse."
      ]
    }
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: retry after the number of seconds in Retry-After.",
    "request_id": "4f3e2d1c-0b9a-4f8e-8d7c-6b5a4f3e2d1c"
  }
}

curl -X GET https://api-commerce.nucleoplatform.com/api/fulfillment/v1/orders/1042/documents \
  -H "Authorization: Bearer $NUCLEO_ACCESS_TOKEN" \
  -H 'Accept: application/json'

const res = await fetch("https://api-commerce.nucleoplatform.com/api/fulfillment/v1/orders/1042/documents", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.NUCLEO_ACCESS_TOKEN}`,
    Accept: "application/json",
  },
});
const data = await res.json();
console.log(res.status, data);

<?php

require 'vendor/autoload.php';

$client = new GuzzleHttp\Client();

$response = $client->request('GET', 'https://api-commerce.nucleoplatform.com/api/fulfillment/v1/orders/1042/documents', [
    'headers' => [
        'Authorization' => 'Bearer ' . getenv('NUCLEO_ACCESS_TOKEN'),
        'Accept' => 'application/json',
    ],
    'http_errors' => false,
]);

echo $response->getStatusCode(), PHP_EOL;
echo $response->getBody();

{
  "data": [
    {
      "id": "7d1c2b3a-4e5f-4a6b-9c8d-1e2f3a4b5c6d",
      "name": "Invoice-2026-001042",
      "kind": "order_document",
      "position": "external",
      "page_format": "A4",
      "content_type": "application/pdf",
      "content_base64": "JVBERi0xLjQKJcfsj6IKNSAwIG9iago8PC9MZW5ndGggNiAwIFI+PgpzdHJlYW0K"
    }
  ]
}

{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid API key.",
    "request_id": "0b6c3e4f-1a2d-4c5b-8e7f-9a0b1c2d3e4f"
  }
}

{
  "error": {
    "code": "connection_paused",
    "message": "This connection is paused: nothing was changed.",
    "request_id": "3c2b1a0f-9e8d-4c7b-a6f5-4e3d2c1b0a9f"
  }
}

{
  "error": {
    "code": "order_not_found",
    "message": "Order 1042 not found.",
    "request_id": "6d5c4b3a-2f1e-4d0c-9b8a-7f6e5d4c3b2a"
  }
}

{
  "error": {
    "code": "order_not_accepted",
    "message": "Accept order",
    "request_id": "9a8b7c6d-5e4f-4a3b-8c2d-1e0f9a8b7c6d"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Too many requests: retry after the number of seconds in Retry-After.",
    "request_id": "4f3e2d1c-0b9a-4f8e-8d7c-6b5a4f3e2d1c"
  }
}