Cufy API
Operaciones

Consultar ejecución por operation_id

GET/v1/operations/{id}

Estado: parcial. Ambientes: simulation, qualification. Permisos: documents:read.

Alcance: Solo consulta operaciones de admisión documental y exige documents:read. Las operaciones de compras, certificados, empresa, solicitudes de producción y exportaciones descritas por el contrato aún no están conectadas.

Dentro de la empresa/ambiente de la credencial se exige el permiso de lectura de la clase de recurso destino. No se acumulan permisos de otras clases ni se concede lectura por conocer operation_id.

Authorization

ClientApiKey
X-API-Key<token>

Secreto ligado a empresa, actor, permisos y ambiente. No admite cambiar empresa por body/header.

In: header

Path Parameters

id*string

Identificador opaco. No autoriza acceso por sí mismo.

Formatuuid
Length1 <= length <= 36

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/operations/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{  "operation_id": "cb4ede3c-a5d1-45e3-a9d2-fe83accbce52",  "resource_id": "4d5215ed-38bb-48ed-879a-fdb9ca58522f",  "resource_type": "string",  "status": "queued",  "created_at": "2019-08-24T14:15:22Z",  "status_url": "../dictionary"}

Admitir PosDebitNote POST

**Estado:** parcial. **Ambientes:** qualification. **Permisos:** `documents:write`. **Alcance:** Solo qualification, sobre un tiquete P.O.S. propio validado, con las mismas reglas de la nota débito de factura: sin nota crédito activa ni más de una débito sin resolver. Consecutivo interno del emisor (tipo pos_debit_note) con configuración SendBillSync. Sin prueba de extremo a extremo propia: comparte admisión y firma con la nota de ajuste crédito. No admite customer_id (422 CUSTOMER_ID_NOT_SUPPORTED): el comprador debe repetir el del original. 202 admite una revisión de forma durable y reserva saldo. La DIAN responde después. Mismo Idempotency-Key o referencia equivalente recupera la admisión original sin nueva reserva, aunque el cliente guardado haya cambiado o se haya archivado después. No transmitir si la capability no está habilitada. Solo buyer completo: customer_id responde 422 CUSTOMER_ID_NOT_SUPPORTED porque el comprador debe coincidir con el del original.

Listar y buscar clientes guardados GET

**Estado:** implementada. **Ambientes:** simulation, qualification. **Permisos:** `documents:read`. **Alcance:** Clientes de la empresa y ambiente de la credencial, con RLS; uno ajeno responde 404 igual que uno inexistente. El comprador se valida con las reglas de la emisión (FISCAL_VALIDATION_FAILED). Sin unicidad por identificación. Del más reciente al más antiguo, activos por defecto; cursor firmado ligado a filtros que caduca en 24 h. q ignora mayúsculas y tildes; sin índice de trigramas. Del más reciente al más antiguo, activos por defecto. Cursor firmado y ligado a filtros, empresa y ambiente; as_of fija el conjunto: los clientes creados después no aparecen hasta empezar de nuevo.