Cargar bolsa de documentos
const url = 'https://example.com/admin/accounts/example/packages';const options = { method: 'POST', headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'}, body: '{"quantity":1,"tenantId":"example","expiresAt":"2026-04-15T12:00:00Z","priceCop":1,"reference":"example"}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}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" }'Authorizations
Sección titulada «Authorizations»Parameters
Sección titulada «Parameters»Path Parameters
Sección titulada «Path Parameters»Id de la cuenta
Request Bodyrequired
Sección titulada «Request Bodyrequired»Una bolsa de documentos comprada por la cuenta
object
Cuántos documentos trae
Cuándo vence; si no se envía, no vence. Los documentos de una bolsa vencida se pierden
Una referencia externa (número de factura u orden)
Example generated
{ "quantity": 1, "tenantId": "example", "expiresAt": "2026-04-15T12:00:00Z", "priceCop": 1, "reference": "example"}Responses
Sección titulada «Responses»Bolsa creada
object
Bolsa creada
object
Id de la bolsa
La cuenta que la compró
Facturador dueño de la bolsa (null: compartida en la cuenta)
Documentos comprados
Documentos consumidos
Precio pagado en COP (informativo)
Una referencia externa (número de factura u orden)
Cuándo se creó
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)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}Falta la credencial o no es válida (UNAUTHORIZED)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}No existe, o no es de esta cuenta (NOT_FOUND)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}Conflicto con el estado actual (CONFLICT, INVALID_STATE)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}Regla de negocio (VALIDATION_ERROR, NUMBERING_*, CERTIFICATE_UNAVAILABLE…)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}Error del servicio o de la DIAN (DIAN_UNAVAILABLE, DIAN_PROTOCOL_ERROR)
Un error: un código estable para los programas y un mensaje para los desarrolladores
object
El error
object
Código estable (VALIDATION_ERROR, NOT_FOUND, INSUFFICIENT_BALANCE…)
Qué salió mal, para desarrolladores (puede cambiar; compare por code)
Datos que lo explican (el campo, el valor esperado…); en un error de esquema, los campos que fallaron y por qué
Id de la petición, para soporte
Example generated
{ "error": { "code": "example", "message": "example", "details": "example", "requestId": "example" }}