Obtener timbrado por su ID

Obtiene información detallada de un timbrado específico usando su ID único. Permite consultar los datos del timbrado.

Entorno

URL Base: https://api.guarani.app

Endpoint

GET /timbrados/{id}

Ejemplo de solicitud

curl -X GET "https://api.guarani.app/timbrados/{id}" \
-H "x-api-key: Bearer <access_token>" \
-H "Accept: application/json" | jq

Nota: Asegúrate de reemplazar {id} con el identificador único del timbrado que deseas consultar y <access_token> con un token JWT válido proporcionado por el equipo Guarani.
Importante:
Es imprescindible incluir un token de acceso válido en el encabezado x-api-key para autenticar y autorizar el uso de este endpoint. Sin este token, la solicitud será rechazada.

Parámetros de ruta

Parámetro	Tipo	Obligatorio	Descripción
`id`	uuid	Sí	Identificador único del timbrado a consultar. (ver `timbrados`).

Encabezados de la solicitud

Encabezado	Valor	Descripción
`x-api-key`	`Bearer <access_token>`	Token de autenticación necesario para acceder al recurso.
`Accept`	`application/json`	Indica que la respuesta debe devolverse en formato JSON.

Ejemplo de respuesta

{
  "success": true,
  "codigo": "200",
  "message": "Operación realizada correctamente.",
  "data": {
    "id": "f57bdf3a-26d0-4a6e-9222-915dcc5c177e",
      "numero_timbrado": "17677531",
      "vigencia_inicio": "11/09/2025",
      "vigencia_fin": null,
      "numero_solicitud": "364010005683",
      "solicitud_fecha": "11/09/2025",
      "timbrados_documentos": [
        {
          "tipo_comprobante": 1,
          "punto_expedicion": "001",
          "serie_inicial": "AA",
          "inicio_numero": "0000001",
          "fin_numero": "9999999",
          "establecimiento": {
            "id": "ejemplo-uuid-establecimiento-123",
            "nombre": "MATRIZ",
            "numero_establecimiento": "001",
            "direccion": "tu direccion",
            "barrio": "tu barrio",
            "ciudad": {
              "id": "67ef2e9f-0fa7-43e7-ad5e-87a694e56341",
              "nombre": "SANTA RITA",
              "codigo_sifen": "3556",
              "distrito_id": "78d49201-91f9-4e6c-aadb-4927f56767c0",
              "distrito": {
                "id": "78d49201-91f9-4e6c-aadb-4927f56767c0",
                "codigo": "209",
                "nombre": "SANTA RITA",
                "departamento": {
                  "id": "750d3163-6a53-45df-b349-e8139d1ff3a9",
                  "codigo": "11",
                  "nombre": "ALTO PARANA"
                }
              }
            }
          }
        }
      ],
      "actividades_economicas": [
        {
          "id": "6b91b3a0-0894-45bc-a130-2b58b8eb8e93",
          "codigo": "C4_47110",
          "nombre": "Comercio al por menor en comercios no especializados con surtido compuesto principalmente por alimentos, bebidas o tabaco",
          "es_principal": true
        }
      ],
      "obligaciones": [
        {
          "id": "a4889c8c-1730-47f3-9650-b0ba06ae4f50",
          "codigo": 41,
          "descripcion": "Aporte obrero al Instituto de Previsión Social (IPS)",
          "fecha_inicio": "11/09/2025"
        }
      ]
    }
  }
}

Descripción de campos de respuesta

Campos principales

Campo	Tipo	Descripción
`id`	uuid	Identificador único del timbrado.
`numero_timbrado`	string	Número del timbrado asignado por la SET.
`vigencia_inicio`	string	Fecha de inicio de vigencia (formato DD/MM/YYYY).
`vigencia_fin`	string	Fecha de fin de vigencia (formato DD/MM/YYYY), puede ser null.
`numero_solicitud`	string	Número de la solicitud presentada ante la SET.
`solicitud_fecha`	string	Fecha de la solicitud (formato DD/MM/YYYY).
`timbrados_documentos`	array	Lista de documentos habilitados por este timbrado.
`actividades_economicas`	array	Lista de actividades económicas del timbrado.
`obligaciones`	array	Obligaciones fiscales asociadas.

Campos de timbrados_documentos

Campo	Tipo	Descripción
`tipo_comprobante`	number	Tipo de comprobante según codificación SIFEN.
`punto_expedicion`	string	Número del punto de expedición.
`serie_inicial`	string	Serie asignada al timbrado.
`inicio_numero`	string	Número inicial de la secuencia.
`fin_numero`	string	Número final de la secuencia.
`establecimiento`	objeto	Información del establecimiento asociado.

Campos de establecimiento

Campo	Tipo	Descripción
`id`	uuid	Identificador único del establecimiento.
`nombre`	string	Nombre del establecimiento.
`numero_establecimiento`	string	Número que identifica al establecimiento.
`direccion`	string	Dirección física del establecimiento.
`barrio`	string	Nombre del barrio.
`ciudad`	objeto	Información de la ciudad.

Campos de ciudad

Campo	Tipo	Descripción
`id`	uuid	Identificador único de la ciudad.
`nombre`	string	Nombre de la ciudad.
`codigo_sifen`	string	Código de la ciudad según el catálogo SIFEN.
`distrito_id`	uuid	Identificador del distrito.
`distrito`	objeto	Información del distrito.

Campos de distrito

Campo	Tipo	Descripción
`id`	uuid	Identificador único del distrito.
`codigo`	string	Código del distrito.
`nombre`	string	Nombre del distrito.
`departamento`	objeto	Información del departamento.

Campos de departamento

Campo	Tipo	Descripción
`id`	uuid	Identificador único del departamento.
`codigo`	string	Código del departamento.
`nombre`	string	Nombre del departamento.

Campos de actividades_economicas

Campo	Tipo	Descripción
`id`	uuid	Identificador único de la actividad económica.
`codigo`	string	Código de la actividad según el catálogo SIFEN.
`nombre`	string	Descripción de la actividad económica.
`es_principal`	boolean	Indica si la actividad es principal (`true`) o secundaria (`false`).

Campos de obligaciones

Campo	Tipo	Descripción
`id`	uuid	Identificador único de la obligación.
`codigo`	number	Código de la obligación según el catálogo oficial.
`descripcion`	string	Descripción de la obligación fiscal.
`fecha_inicio`	string	Fecha de inicio de la obligación (formato DD/MM/YYYY).

Recursos adicionales

Para más información sobre posibles errores y cómo manejarlos, consulta errores.