Ir al contenido

Cargar bolsa de documentos

POST
/admin/accounts/{id}/packages
curl --request POST \
--url https://example.com/admin/accounts/example/packages \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{ "quantity": 1, "tenantId": "example", "expiresAt": "2026-04-15T12:00:00Z", "priceCop": 1, "reference": "example" }'
id
required
string

Id de la cuenta

Media typeapplication/json

Una bolsa de documentos comprada por la cuenta

object
quantity
required

Cuántos documentos trae

integer
> 0 <= 9007199254740991
tenantId

Facturador al que pertenece, por su id; null o sin enviar: compartida entre todos los facturadores de la cuenta

Any of:
string
<= 36 characters
expiresAt

Cuándo vence; si no se envía, no vence. Los documentos de una bolsa vencida se pierden

string format: date-time
priceCop

Precio pagado, en COP; informativo

Any of:
number
reference

Una referencia externa (número de factura u orden)

string
<= 200 characters

Example generated

{
"quantity": 1,
"tenantId": "example",
"expiresAt": "2026-04-15T12:00:00Z",
"priceCop": 1,
"reference": "example"
}

Bolsa creada

Media typeapplication/json
object
data
required

Bolsa creada

object
id
required

Id de la bolsa

string
accountId
required

La cuenta que la compró

string
tenantId
required

Facturador dueño de la bolsa (null: compartida en la cuenta)

string | null
quantity
required

Documentos comprados

integer
>= -9007199254740991 <= 9007199254740991
used
required

Documentos consumidos

integer
>= -9007199254740991 <= 9007199254740991
expiresAt
required

Vencimiento (null: no vence)

Any of:

Fecha y hora en UTC (ISO 8601)

string format: date-time
priceCop

Precio pagado en COP (informativo)

string
reference

Una referencia externa (número de factura u orden)

string
createdAt
required

Cuándo se creó

string format: date-time

Example

{
"data": {
"expiresAt": "2026-01-15T15:30:00.000Z",
"createdAt": "2026-01-15T15:30:00.000Z"
}
}

La petición no cumple el esquema (VALIDATION_ERROR, con details por campo)

Media typeapplication/json

Un error: un código estable para los programas y un mensaje para los desarrolladores

object
error
required

El error

object
code
required

Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)

string
message
required

Qué salió mal, para desarrolladores (puede cambiar; compare por code)

string
details

Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué

requestId

Id de la petición, para soporte

string

Example generated

{
"error": {
"code": "example",
"message": "example",
"details": "example",
"requestId": "example"
}
}

Falta la credencial o no es válida (UNAUTHORIZED)

Media typeapplication/json

Un error: un código estable para los programas y un mensaje para los desarrolladores

object
error
required

El error

object
code
required

Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)

string
message
required

Qué salió mal, para desarrolladores (puede cambiar; compare por code)

string
details

Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué

requestId

Id de la petición, para soporte

string

Example generated

{
"error": {
"code": "example",
"message": "example",
"details": "example",
"requestId": "example"
}
}

No existe, o no es de esta cuenta (NOT_FOUND)

Media typeapplication/json

Un error: un código estable para los programas y un mensaje para los desarrolladores

object
error
required

El error

object
code
required

Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)

string
message
required

Qué salió mal, para desarrolladores (puede cambiar; compare por code)

string
details

Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué

requestId

Id de la petición, para soporte

string

Example generated

{
"error": {
"code": "example",
"message": "example",
"details": "example",
"requestId": "example"
}
}

Conflicto con el estado actual (CONFLICT, INVALID_STATE)

Media typeapplication/json

Un error: un código estable para los programas y un mensaje para los desarrolladores

object
error
required

El error

object
code
required

Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)

string
message
required

Qué salió mal, para desarrolladores (puede cambiar; compare por code)

string
details

Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué

requestId

Id de la petición, para soporte

string

Example generated

{
"error": {
"code": "example",
"message": "example",
"details": "example",
"requestId": "example"
}
}

Regla de negocio (VALIDATION_ERROR, NUMBERING_*, CERTIFICATE_UNAVAILABLE…)

Media typeapplication/json

Un error: un código estable para los programas y un mensaje para los desarrolladores

object
error
required

El error

object
code
required

Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)

string
message
required

Qué salió mal, para desarrolladores (puede cambiar; compare por code)

string
details

Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué

requestId

Id de la petición, para soporte

string

Example generated

{
"error": {
"code": "example",
"message": "example",
"details": "example",
"requestId": "example"
}
}

Error del servicio o de la DIAN (DIAN_UNAVAILABLE, DIAN_PROTOCOL_ERROR)

Media typeapplication/json

Un error: un código estable para los programas y un mensaje para los desarrolladores

object
error
required

El error

object
code
required

Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)

string
message
required

Qué salió mal, para desarrolladores (puede cambiar; compare por code)

string
details

Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué

requestId

Id de la petición, para soporte

string

Example generated

{
"error": {
"code": "example",
"message": "example",
"details": "example",
"requestId": "example"
}
}