Documentación para desarrolladoresReferencia de la APITrabajos

Consultar el resultado de un trabajo

El plan de carga de un trabajo completado: cada vehículo usado, cada colocación, lo que no cupo y el enlace al PDF.

GEThttps://runner.cargoduo.com/v1/jobs/{id}/result

Autenticación

Clave de API Bearer con el permisojobs:readMás información

Parámetros de ruta

NombreTipoObligatorioDescripción

idstringobligatorio

string

Sí

ID del trabajo (job_…).

Ejemplo de solicitud

curl -X GET "https://runner.cargoduo.com/v1/jobs/job_4bK9mT2xQe7LpW1zRc8VdN3f/result" \
  -H "Authorization: Bearer $CARGODUO_API_KEY"

const res = await fetch("https://runner.cargoduo.com/v1/jobs/job_4bK9mT2xQe7LpW1zRc8VdN3f/result", {
  method: "GET",
  headers: {
    Authorization: `Bearer ${process.env.CARGODUO_API_KEY}`,
  },
});

const data = await res.json();
console.log(res.status, data);

import os
import requests

response = requests.get(
    "https://runner.cargoduo.com/v1/jobs/job_4bK9mT2xQe7LpW1zRc8VdN3f/result",
    headers={"Authorization": f"Bearer {os.environ['CARGODUO_API_KEY']}"},
)
print(response.status_code, response.json())

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest("GET", "https://runner.cargoduo.com/v1/jobs/job_4bK9mT2xQe7LpW1zRc8VdN3f/result", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("Authorization", "Bearer "+os.Getenv("CARGODUO_API_KEY"))

	res, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer res.Body.Close()

	out, _ := io.ReadAll(res.Body)
	fmt.Println(res.StatusCode, string(out))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class Main {
    public static void main(String[] args) throws Exception {
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://runner.cargoduo.com/v1/jobs/job_4bK9mT2xQe7LpW1zRc8VdN3f/result"))
            .header("Authorization", "Bearer " + System.getenv("CARGODUO_API_KEY"))
            .method("GET", HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = HttpClient.newHttpClient()
            .send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.statusCode() + " " + response.body());
    }
}

using System.Net.Http.Headers;
using System.Text;

using var client = new HttpClient();
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer", Environment.GetEnvironmentVariable("CARGODUO_API_KEY"));

var request = new HttpRequestMessage(HttpMethod.Get, "https://runner.cargoduo.com/v1/jobs/job_4bK9mT2xQe7LpW1zRc8VdN3f/result");
var response = await client.SendAsync(request);
Console.WriteLine($"{(int)response.StatusCode} {await response.Content.ReadAsStringAsync()}");

<?php

$ch = curl_init('https://runner.cargoduo.com/v1/jobs/job_4bK9mT2xQe7LpW1zRc8VdN3f/result');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST => 'GET',
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('CARGODUO_API_KEY'),
    ],
]);

$response = curl_exec($ch);
echo curl_getinfo($ch, CURLINFO_HTTP_CODE), ' ', $response, PHP_EOL;

require "net/http"
require "uri"

uri = URI("https://runner.cargoduo.com/v1/jobs/job_4bK9mT2xQe7LpW1zRc8VdN3f/result")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer #{ENV.fetch("CARGODUO_API_KEY")}"

response = Net::HTTP.start(uri.host, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end
puts response.code, response.body

Ejemplo de respuesta

200 OK · Result

{
  "job_id": "job_4bK9mT2xQe7LpW1zRc8VdN3f",
  "vehicles": [
    {
      "index": 0,
      "vehicle_id": "trailer",
      "copy": 1,
      "auto_added": false,
      "name": "13.6 m trailer",
      "type": "trailer",
      "length": 1360,
      "width": 245,
      "height": 270,
      "max_weight": 24000,
      "items_placed": 58,
      "total_weight": 8580,
      "volume_utilization": 0.3116,
      "weight_utilization": 0.3575,
      "center_of_gravity": {
        "x": 452.6,
        "y": 68.4,
        "z": 121.8
      },
      "axle_loads": [],
      "placements": [
        {
          "item_id": "pallet-eu",
          "instance": 1,
          "label": "Euro pallet",
          "x": 0,
          "y": 0,
          "z": 0,
          "length": 80,
          "width": 120,
          "height": 140,
          "rotated": true,
          "orientation": "wlh",
          "step": 1,
          "weight": 450
        },
        {
          "item_id": "pallet-eu",
          "instance": 2,
          "label": "Euro pallet",
          "x": 0,
          "y": 0,
          "z": 120,
          "length": 80,
          "width": 120,
          "height": 140,
          "rotated": true,
          "orientation": "wlh",
          "step": 2,
          "weight": 450
        },
        {
          "item_id": "carton-a",
          "instance": 1,
          "label": "Carton A",
          "x": 720,
          "y": 0,
          "z": 0,
          "length": 60,
          "width": 40,
          "height": 40,
          "rotated": false,
          "orientation": "lwh",
          "step": 19,
          "weight": 12
        }
      ]
    }
  ],
  "unplaced": [],
  "warnings": [],
  "pdf_url": "https://app.cargoduo.com/r/Xq7Lm2Vt9KbR4cN8wZp1Hs6Yd3Fg5Jk0Ta2Ue7Wn4Ci",
  "expires_at": "2026-11-02T09:12:03Z"
}

Abreviado: se muestran 3 de las 58 colocaciones.

Respuestas

200OKEl plan de carga.Result
NombreTipoObligatorioDescripción
job_idstring
string
No
El trabajo.
vehiclesResultVehicle[]
ResultVehicle[]
No
Vehículos cargados en orden de carga (se omiten los vacíos).
unplacedUnplacedItem[]
UnplacedItem[]
No
Unidades que no se pudieron colocar, con el motivo.
warningsWarning[]
Warning[]
No
Observaciones sobre el plan.
pdf_urlstring
string
No
Enlace que, abierto en un navegador, genera el plan en PDF.
expires_atstring
string
No
Cuándo se elimina este resultado (RFC 3339).
401Unauthorizedunauthorizedkey_revokedkey_expiredError
- unauthorizedClave de API ausente, mal formada o desconocida.
- key_revokedLa clave se ha revocado.
- key_expiredLa clave ha superado su fecha de caducidad.
NombreTipoObligatorioDescripción
errorErrorBodyobligatorio
ErrorBody
Sí
Todos los códigos de error
403Forbiddenip_not_allowedsubscription_inactiveaccount_inactivescope_missingError
- ip_not_allowedLa IP de origen no está en la lista de IP permitidas de la clave.
- subscription_inactiveLa organización no tiene ninguna suscripción activa que incluya la API.
- account_inactiveLa organización está suspendida o no tiene ningún propietario con la cuenta activa.
- scope_missingA la clave le falta un permiso que requiere este endpoint.
NombreTipoObligatorioDescripción
errorErrorBodyobligatorio
ErrorBody
Sí
Todos los códigos de error
404Not foundjob_not_foundError
- job_not_foundNo hay ningún trabajo con este ID en tu organización.
NombreTipoObligatorioDescripción
errorErrorBodyobligatorio
ErrorBody
Sí
Todos los códigos de error
409Conflictjob_not_finishedjob_failedjob_canceledError
- job_not_finishedEl trabajo sigue en cola o en curso.
- job_failedEl trabajo ha fallado; no tiene resultado.
- job_canceledEl trabajo se canceló; no tiene resultado.
NombreTipoObligatorioDescripción
errorErrorBodyobligatorio
ErrorBody
Sí
Todos los códigos de error
410Goneresult_expiredError
- result_expiredEl resultado superó el periodo de conservación y se eliminó.
NombreTipoObligatorioDescripción
errorErrorBodyobligatorio
ErrorBody
Sí
Todos los códigos de error
429Too many requestsrate_limitedError
- rate_limitedDemasiadas solicitudes en el minuto, la hora o el día en curso (por clave o por organización), o más de 60 autenticaciones fallidas por minuto desde tu dirección IP.
NombreTipoObligatorioDescripción
errorErrorBodyobligatorio
ErrorBody
Sí
Todos los códigos de error
500Internal server errorinternal_errorError
- internal_errorAlgo ha fallado por nuestra parte.
NombreTipoObligatorioDescripción
errorErrorBodyobligatorio
ErrorBody
Sí
Todos los códigos de error
503Service unavailableapi_disabledError
- api_disabledLa API está desactivada temporalmente (mantenimiento) o deshabilitada para la organización.
NombreTipoObligatorioDescripción
errorErrorBodyobligatorio
ErrorBody
Sí
Todos los códigos de error

Resultados y coordenadasDónde va cada artículo, con qué orientación y en qué orden de carga.Informes PDFUn enlace que se puede compartir y que genera el PDF del plan de carga.GETConsultar un trabajoEstado, progreso, resumen y coste de un trabajo.

Autenticación

Parámetros de ruta

Ejemplo de solicitud

Ejemplo de respuesta

Respuestas

Relacionado