Impuestos de los documentos aceptados del período

GET/api/v1/reports/taxes

Ventas (facturas + notas débito − notas crédito) por tributo y tarifa, e IVA descontable de documentos soporte. Máximo un año.

Parámetros de consulta

fromstring · dateobligatorio
Ejemplo: 2026-11-01
tostring · dateobligatorio
Ejemplo: 2026-11-30

Respuestas

200OK

fromstring · date
tostring · date
statusstring
Ejemplo: accepted
currencystring
Ejemplo: COP
taxesarray<object>
+ Ver 8 campos− Ocultar 8 campos
- tax_codestring
- tax_namestring
- ratestring
- invoicesobject
  + Ver 3 campos− Ocultar 3 campos
  - documentsinteger
  - basestring
    Ejemplo: 5000.00
  - amountstring
    Ejemplo: 5000.00
- credit_notesobject
  + Ver 3 campos− Ocultar 3 campos
  - documentsinteger
  - basestring
    Ejemplo: 5000.00
  - amountstring
    Ejemplo: 5000.00
- debit_notesobject
  + Ver 3 campos− Ocultar 3 campos
  - documentsinteger
  - basestring
    Ejemplo: 5000.00
  - amountstring
    Ejemplo: 5000.00
- net_basestring
  Ejemplo: 5000.00
- net_amountstring
  Ejemplo: 5000.00
purchase_taxesarray<object>
+ Ver 7 campos− Ocultar 7 campos
- tax_codestring
- tax_namestring
- ratestring
- support_documentsobject
  + Ver 3 campos− Ocultar 3 campos
  - documentsinteger
  - basestring
    Ejemplo: 5000.00
  - amountstring
    Ejemplo: 5000.00
- adjustmentsobject
  + Ver 3 campos− Ocultar 3 campos
  - documentsinteger
  - basestring
    Ejemplo: 5000.00
  - amountstring
    Ejemplo: 5000.00
- net_basestring
  Ejemplo: 5000.00
- net_amountstring
  Ejemplo: 5000.00
documentsobject<string, object>

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

Respuesta

{
  "from": "2026-11-30",
  "to": "2026-11-30",
  "status": "accepted",
  "currency": "COP",
  "taxes": [
    {
      "tax_code": "texto",
      "tax_name": "texto",
      "rate": "texto",
      "invoices": {
        "documents": 1,
        "base": "5000.00",
        "amount": "5000.00"
      },
      "credit_notes": {
        "documents": 1,
        "base": "5000.00",
        "amount": "5000.00"
      },
      "debit_notes": {
        "documents": 1,
        "base": "5000.00",
        "amount": "5000.00"
      },
      "net_base": "5000.00",
      "net_amount": "5000.00"
    }
  ],
  "purchase_taxes": [
    {
      "tax_code": "texto",
      "tax_name": "texto",
      "rate": "texto",
      "support_documents": {
        "documents": 1,
        "base": "5000.00",
        "amount": "5000.00"
      },
      "adjustments": {
        "documents": 1,
        "base": "5000.00",
        "amount": "5000.00"
      },
      "net_base": "5000.00",
      "net_amount": "5000.00"
    }
  ],
  "documents": {}
}