Factuarea API
Tipos impositivos

Obtener los impuestos por defecto para un tipo de documento

Devuelve los impuestos predeterminados configurados (vat, retention, surcharge) para el tipo de documento indicado, en el ámbito de tu empresa. Cada espacio es un Tax o null cuando no hay predeterminado configurado.

GET
/taxes/defaults/{docType}

Authorization

AuthorizationBearer <token>

En: header

Parámetros de ruta

docType*string

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

application/json

{
  "data": {
    "vat": [],
    "retention": [],
    "surcharge": [],
    "other": []
  }
}

{
  "error": {
    "type": "authentication_error",
    "code": "missing_api_key",
    "message": "No se ha proporcionado una API key válida en el header Authorization.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#missing_api_key",
    "request_id": "req_01HKQS5N8VR7QXJ9K3T6BWPMZA"
  }
}

{
  "error": {
    "type": "authorization_error",
    "code": "insufficient_scope",
    "message": "Esta API key no tiene el scope requerido para esta operación.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#insufficient_scope",
    "request_id": "req_01HKQS5NBC3P8M1KX4V7SLNHQD"
  }
}

{
  "error": {
    "type": "rate_limit_error",
    "code": "rate_limit_exceeded",
    "message": "Has excedido el rate limit de 60 peticiones por minuto. Reintenta tras 30 segundos.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#rate_limit_exceeded",
    "request_id": "req_01HKQS5NKW1C6W9T4G5H0JBZVL"
  }
}

{
  "error": {
    "type": "api_error",
    "code": "internal_error",
    "message": "Ha ocurrido un error inesperado. Si persiste, contacta con soporte adjuntando el request_id.",
    "param": null,
    "doc_url": "https://docs.factuarea.com/guides/errors#internal_error",
    "request_id": "req_01HKQS5NLX2D7X0U5H6J1KCAWM"
  }
}

Crea un impuesto

Registra un nuevo impuesto con nombre, código único, tipo (vat, retention, surcharge u other), tasa y ámbito (sale, purchase o both). El código de país ISO-2 es obligatorio.

Elimina un impuesto

Elimina un impuesto. Falla con 409 si el impuesto está referenciado por documentos existentes. Los impuestos de sistema (is_system=true) no se pueden eliminar.