Docs
Solicitar acceso

Consumo de documentos del período

POST/api/v1/account/usage

Cuenta solo documentos aceptados por la DIAN (los rechazados no consumen), por cuenta y tipo. Una cuenta hija ve lo suyo. Una cuenta sin padre (independiente o casa de software) ve lo suyo y lo de todas sus hijas; con account_ids, solo esas. Máximo un año.

Cuerpo de la petición application/json

  • fromstring · dateobligatorio

    Ejemplo: 2026-11-01

  • tostring · dateobligatorio

    Ejemplo: 2026-11-30

  • account_idsarray<string · uuid>

    Solo para casas de software; vacío = todas sus cuentas

Respuestas

200OK
  • fromstring · date
  • tostring · date
  • totalinteger

    Ejemplo: 1250

  • itemsarray<object>
    + Ver 5 campos− Ocultar 5 campos
    • account_idstring · uuid
    • nitstring

      Ejemplo: 900123456

    • namestring

      Ejemplo: Cliente Uno SAS

    • document_typestring

      Valores: invoice · credit_note · debit_note · support_document · support_document_adjustment · payroll · payroll_adjustment · pos · pos_adjustment · pos_debit_adjustment

    • documentsinteger

      Ejemplo: 840

400Datos inválidos (details trae los campos)
  • codestring

    Ejemplo: error.document.invalid

  • messagestring
  • errorsarray<object>

    Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)

    + Ver 2 campos− Ocultar 2 campos
    • fieldstring

      Ruta del campo en el JSON enviado

      Ejemplo: lines[0].quantity

    • messagestring

      Ejemplo: Cantidad inválida: debe ser mayor que cero.

  • detailsarray<string>

    Rutas de los campos inválidos (compatibilidad; usa errors)

  • request_idstring
401Falta la key o es inválida, está deshabilitada, vencida o revocada (error.missing_api_key, error.invalid_api_key, error.api_key.disabled, error.api_key.expired, error.api_key.revoked)
  • codestring

    Ejemplo: error.document.invalid

  • messagestring
  • errorsarray<object>

    Solo en 400: cada campo inválido con su explicación (en español, o en inglés con Accept-Language: en)

    + Ver 2 campos− Ocultar 2 campos
    • fieldstring

      Ruta del campo en el JSON enviado

      Ejemplo: lines[0].quantity

    • messagestring

      Ejemplo: Cantidad inválida: debe ser mayor que cero.

  • detailsarray<string>

    Rutas de los campos inválidos (compatibilidad; usa errors)

  • request_idstring