Obtener PDF de entrega

Para obtener el PDF de una entrega particular que ya ha sido completada en Persat se debe realizar un GET como el que se muestra a continuación.

GET https://api.persat.com.ar/v1/deliveries/pdf/delivery_id

Solo se pueden obtener una vez que se hayan realizado. Es decir, una vez que esté en estado FINISHED, FINISHED_WITH_DEVIATION o NOT_FINISHED.

Path Parameters

Name

Type

Description

delivery_id*

String

Identificador de la entrega.

Query Parameters

Name

Type

Description

format

String

Si se envía "base64", el PDF se devolverá en base64. Si no se envía, la API responderá con un archivo binario.

Headers

Name

Type

Description

Authorization*

String

Bearer API_KEY

Ejemplo en formato binario

Las respuestas en formato binario retornan directamente la descarga del archivo.

Request con curl

curl -H "Authorization: Bearer API_KEY" \
     -J -O \
     https://api.persat.com.ar/v1/deliveries/pdf/NEWM23049

Respuesta

HTTP/1.1 200 OK
Content-Type: application/pdf
Transfer-Encoding: chunked
Content-Disposition: attachment; filename="NEWM23049.pdf"

<Binary Data>

HTTP/1.1 409 CONFLICT
Content-Type: application/json

{
    "success": false,
    "error": {
        "status": 409,
        "type": "CONFLICT",
        "userMessage": "La entrega 'NEWM23049' debe estar completada para poder generar el PDF"
    }
}

HTTP/1.1 404 NOT_FOUND
Content-Type: application/json

{
    "success": false,
    "error": {
        "status": 404,
        "type": "NOT_FOUND",
        "userMessage": "No existe una entrega con este nro."
    }
}

Analizando la Respuesta en formato base64

{
    "success": true,
    "data": {
        "pdf": "JVBERi0xLjQKJdPr6eEKMSAwIG9iago8PC9DcmVh[...]", // Base64
        "name": "NEWM23049.pdf",
    }
}

{
    "success": false,
    "error": {
        "status": 409,
        "type": "CONFLICT",
        "userMessage": "La entrega 'NEWM23049' debe estar completada para poder generar el PDF"
    }
}

{
    "success": false,
    "error": {
        "status": 404,
        "type": "NOT_FOUND",
        "userMessage": "No existe una entrega con este nro."
    }
}

pdf: Es un string. Representa el pdf en base64.

name: Es un string. Nombre sugerido del pdf.

Ejemplo de PDF descargado

Last updated 1 month ago

HTTP/1.1 409 CONFLICT Content-Type: application/json { "success": false, "error": { "status": 409, "type": "CONFLICT", "userMessage": "La entrega 'NEWM23049' debe estar completada para poder generar el PDF" } }

HTTP/1.1 404 NOT_FOUND Content-Type: application/json { "success": false, "error": { "status": 404, "type": "NOT_FOUND", "userMessage": "No existe una entrega con este nro." } }