Fiscalbase
PlataformaEstado de la API
GuíasReferencia de la API
Guías de remisión

Emitir guía de remisión

POST
/v1/ec/delivery-notes

Numera el comprobante, lo guarda y lo encola para firmarlo y enviarlo al SRI. El estado avanza solo: consúltalo o recibe un webhook. Envía un Idempotency-Key para reintentar sin duplicar.

Autorización

AutorizaciónBearer <tu clave API>

Tu clave API: fb_sandbox_… emite en Sandbox, fb_test_… en test, el servicio de pruebas de la autoridad tributaria, y fb_live_… en live, su producción.

En: header

Encabezados

idempotency-key?string
Longitud1 <= length <= 255

Cuerpo de la solicitud

application/json

Tipos de TypeScript

Usa el tipo request body en TypeScript.

La fecha de emisión es siempre hoy en Ecuador: los comprobantes se transmiten al emitirse.

origin_address*string
Patrón^[^\n\r]*$
Longitud1 <= length <= 300
carrier*||
plate*string
Patrón^[A-Z0-9-]{1,20}$
transport_start*string
Formatodate
transport_end*string
Formatodate
recipients*array<>
Elementos1 <= items
fiscal_machine?

La máquina fiscal desde la que se emite el comprobante (anexo 13). Solo si lo emite una.

additional_info?array<>
Por defecto[]
entity_id?string
Formatouuid
establishment?string
Patrón^\d{3}$
emission_point?string
Patrón^\d{3}$
metadata?
Por defecto{}
simulate?

Cuerpo de la respuesta

application/json

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/v1/ec/delivery-notes" \  -H "Content-Type: application/json" \  -d '{    "origin_address": "string",    "carrier": {      "identification_type": "ruc",      "identification": "string",      "name": "string"    },    "plate": "string",    "transport_start": "2019-08-24",    "transport_end": "2019-08-24",    "recipients": [      {        "identification": "string",        "name": "string",        "address": "string",        "email": "user@example.com",        "reason": "string",        "items": [          {            "description": "string",            "quantity": "string"          }        ]      }    ]  }'
{  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",  "country": "ec",  "currency": "string",  "environment": "sandbox",  "status": "pending",  "status_transitions": {    "pending": "2019-08-24T14:15:22Z",    "submitted": "2019-08-24T14:15:22Z",    "authorized": "2019-08-24T14:15:22Z",    "returned": "2019-08-24T14:15:22Z",    "not_authorized": "2019-08-24T14:15:22Z",    "annulled": "2019-08-24T14:15:22Z"  },  "entity_id": "8161163a-f227-466f-bc01-090a01e80165",  "number": "string",  "access_key": "stringstringstringstringstringstringstringstrings",  "authorization": {    "number": "string",    "authorized_at": "2019-08-24T14:15:22Z"  },  "sri_messages": [    {      "code": "string",      "message": "string",      "detail": "string",      "type": "error"    }  ],  "metadata": {    "property1": "string",    "property2": "string"  },  "issued_at": "2019-08-24T14:15:22Z",  "delivery_status": "sent",  "emails": [    {      "to": "string",      "status": "sent",      "sent_at": "2019-08-24T14:15:22Z",      "delivered_at": "2019-08-24T14:15:22Z",      "opened_at": "2019-08-24T14:15:22Z",      "bounced_at": "2019-08-24T14:15:22Z",      "complained_at": "2019-08-24T14:15:22Z",      "bounce_type": "permanent"    }  ],  "portal_views": 0,  "portal_last_viewed_at": "2019-08-24T14:15:22Z",  "channel": "api",  "import_id": "13230382-dadc-41f2-963d-e123bd5c0585",  "verification": "sri",  "listing": {    "import_id": "13230382-dadc-41f2-963d-e123bd5c0585",    "file": "string",    "entry": "string",    "sha256": "stringstringstringstringstringstringstringstringstringstringstri",    "line": 1,    "authorized_at": "2019-08-24T14:15:22Z"  },  "object": "delivery_note",  "issue_date": "string",  "origin_address": "string",  "carrier": {    "identification_type": "ruc",    "identification": "string",    "name": "string"  },  "plate": "string",  "transport_start": "string",  "transport_end": "string",  "recipients": [    {      "identification": "string",      "name": "string",      "address": "string",      "email": "string",      "reason": "string",      "route": "string",      "customs_document": "string",      "destination_establishment": "string",      "support_document": {        "document_type": "factura",        "number": "string",        "issue_date": "string",        "authorization_number": "string"      },      "items": [        {          "code": "string",          "auxiliary_code": "string",          "description": "string",          "quantity": "string",          "additional_info": [            {              "name": "string",              "value": "string"            }          ]        }      ]    }  ],  "fiscal_machine": {    "brand": "string",    "model": "string",    "serial": "string"  },  "additional_info": [    {      "name": "string",      "value": "string"    }  ],  "created_at": "2019-08-24T14:15:22Z",  "updated_at": "2019-08-24T14:15:22Z"}

Registrar la anulación de guía de remisión POST

Solo registra una anulación que ya hiciste en SRI en línea; no la pide al SRI. El comprobante pasa a `annulled`, conserva sus archivos, sale del portal de tu cliente y se envía `<object>.annulled` a tus webhooks. Solo para uno `authorized`, y nunca para uno emitido a consumidor final, que el SRI no anula.

Listar guías de remisión GET

Del más reciente al más antiguo, en el ambiente de tu clave.