Listar guías de remisión

GET

/v1/delivery-guides

curl --request GET \
  --url 'https://api.chaski.ec/v1/delivery-guides?status=pending&limit=20' \
  --header 'Authorization: Bearer <token>'

Con recipient=<RUC o cédula> devuelve solo las guías cuyo primer destinatario es ese.

Authorizations

• apiKey

Parameters

Query Parameters

status

string

Allowed values: pending received authorized rejected failed

recipient

string

<= 20 characters

external_ref

string

<= 255 characters

limit

integer

default: 20 >= 1 <= 100

starting_after

string

Responses

200

OK

Media typeapplication/json

object

data

required

Array<object>

object

id

required

string

status

required

string

Allowed values: pending received authorized rejected failed

environment

required

string

Allowed values: test live

issuer

required

string

emission_point

required

string

number

required

string

access_key

required

Clave de acceso de 49 dígitos

string

issue_date

required

string format: date

/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$/

departure_address

required

string

carrier

required

object

id_type

required

string

Allowed values: ruc cedula passport foreign

id

required

string

name

required

string

rise

required

string | null

plate

required

string

transport_start

required

string format: date

/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$/

transport_end

required

string format: date

/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$/

recipients

required

Array<object>

object

id

required

string

name

required

string

address

required

string

reason

required

string

customs_document

required

string | null

destination_establishment

required

string | null

route

required

string | null

supporting_document

required

Any of:

object

object

type

required

string

number

required

string

authorization_number

required

string | null

issue_date

required

Any of:

string

string format: date

/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$/

null

null

null

null

items

required

Array<object>

object

code

required

string | null

auxiliary_code

required

string | null

description

required

string

quantity

required

string

details

required

object

key

additional properties

string

email

required

string | null

external_ref

required

string | null

metadata

required

object

key

additional properties

string

sri_messages

required

Array<object>

object

code

required

string

type

required

string

message

required

string

additional_info

string

authorized_at

required

Any of:

string

string format: date-time

/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$/

null

null

created_at

required

string format: date-time

/^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$/

has_more

required

boolean

Example

{
  "data": [
    {
      "id": "dg_01jbx3k9q2f8m4tn6vwz0yh5ce",
      "status": "pending",
      "environment": "test",
      "emission_point": "001-002",
      "number": "001-002-000000015",
      "carrier": {
        "id_type": "ruc"
      },
      "plate": "GBA-1234",
      "recipients": [
        {
          "supporting_document": {
            "type": "01",
            "number": "001-001-000000123"
          },
          "items": [
            {
              "quantity": "10.000000"
            }
          ]
        }
      ]
    }
  ]
}

400

Petición inválida

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

field

string

key

additional properties

Example

{
  "error": {
    "code": "invalid_request"
  }
}

401

Falta la API key o no es válida

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

field

string

key

additional properties

Example

{
  "error": {
    "code": "invalid_request"
  }
}

429

Demasiadas peticiones

Media typeapplication/json

object

error

required

object

code

required

string

message

required

string

field

string

key

additional properties

Example

{
  "error": {
    "code": "invalid_request"
  }
}