Referencia de la API

Generada del mismo contrato que openapi.json(OpenAPI 3.1). Versión 2026-10-01.Toda respuesta viene en { data }; los errores, en { error, code, request_id, doc_url }.

Cuenta

GET`/api/v1/me`

Organización y alcance de la llavescope: read

curl https://cordhq.app/api/v1/me \
  -H "Authorization: Bearer sk_test_..."

const me = await cord.me();

Respuesta: data

`org`	`object`	Organización dueña de la llave.
`scope`	`string`	read o write: lo que puede hacer la llave.
`mode`	`"live" \| "test"`	live o test: con test todo ocurre en la sandbox y no toca datos reales.

Cotizaciones

GET`/api/v1/cotizaciones`

Listar cotizacionesscope: readPaginación por offset

Parámetros: limit, offset, cursor, status, folio, cliente_id

curl https://cordhq.app/api/v1/cotizaciones \
  -H "Authorization: Bearer sk_test_..."

for await (const item of cord.quotes.listAll()) {
  console.log(item.id);
}

Respuesta: data[]

`id`	`string`	Identificador (UUID).
`folio`	`string`	Folio legible asignado por Cord, por ejemplo COT-0042.
`cliente`	`string \| null`	Cliente al que va dirigido: nombre de la empresa, o los datos para darlo de alta si no existe.
`status`	`string`	Estado de la cotización: draft, sent, viewed, approved, rejected, expired, paid o invoiced.
`total`	`number`	Importe en la divisa indicada por `moneda`.
`moneda`	`string \| null`	Divisa ISO 4217.
`terminos`	`string \| null`	Etiqueta legible del plazo en el idioma de la cuenta ("Contado", "Net 45"); para comparar usa terminos_codigo.
`terminos_codigo`	`string \| null`	Código estable del plazo: contado o net<N> (net7, net15, net30, net45, net60, net90).
`vigencia`	`string \| null`	Fecha ISO 8601.
`creada`	`string \| null`	Fecha ISO 8601.
`link_publico`	`string`	Link público absoluto de la cotización.
`language`	`"es" \| "en" \| "pt" \| "fr" \| "de" \| null`	Solo lectura. Idioma con que se envió: es, en, pt, fr o de. null mientras es borrador, que sigue el idioma del cliente.

POST`/api/v1/cotizaciones`

Crear cotizaciónAcepta pk_scope: write

Campo	Tipo	Descripción
`items` requerido	`object[]`	Líneas.
`cliente_id`	`string`	ID de un cliente del directorio.
`cliente`	`object`	Cliente al que va dirigido: nombre de la empresa, o los datos para darlo de alta si no existe.
`terminos`	`"contado" \| "net7" \| "net15" \| "net30" \| "net45" \| "net60" \| "net90"`	Términos de pago: contado o net<N> (N días de crédito: 7, 15, 30, 45, 60 o 90).
`vigencia_dias`	`integer`	Días que la cotización es válida desde su envío.
`notas`	`string`	Notas internas; el cliente no las ve.
`base_currency`	`string`	Divisa de venta ISO 4217: en la que se capturan los precios, se cobra y se factura. Default: la del negocio.
`fiscal_currency`	`string`	Divisa contable ISO 4217; si difiere de la de venta, la factura declara el tipo de cambio.
`iva_incluido`	`boolean`	true si los precios capturados ya incluyen el impuesto.
`descuento`	`object \| null`	Descuento de documento antes de impuestos, repartido entre las líneas en proporción a su importe. Cord calcula el monto; null lo quita.
`cupon`	`string`	Código de un cupón del negocio. Cord valida vigencia, divisa y usos; si viene, manda sobre descuento. Es el único descuento que admite una llave publicable.
`send`	`boolean`	Solo con Secret Key.

curl -X POST https://cordhq.app/api/v1/cotizaciones \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"cliente":{"empresa":"Acme"},"items":[{"descripcion":"Instalación","cantidad":1,"precio_unitario":12500,"tax_rate":0.16}],"base_currency":"MXN"}'

const created = await cord.quotes.create({
  "cliente": {
    "empresa": "Acme"
  },
  "items": [
    {
      "descripcion": "Instalación",
      "cantidad": 1,
      "precio_unitario": 12500,
      "tax_rate": 0.16
    }
  ],
  "base_currency": "MXN"
});

Respuesta: data

`id`	`string`	Identificador (UUID).
`token`	`string`	Token del link público. Es una credencial: no lo publiques.
`folio`	`string`	Folio legible asignado por Cord, por ejemplo COT-0042.
`link_publico`	`string`	Link público absoluto que se comparte con el cliente.
`needs_approval`	`boolean`	true si quedó retenida esperando aprobación interna antes de enviarse.
`motivo`	`string \| null`	Razón, escrita por una persona.
`email`	`object`	Correo electrónico.

GET`/api/v1/cotizaciones/{id}`

Detalle de cotizaciónscope: read

curl https://cordhq.app/api/v1/cotizaciones/ID \
  -H "Authorization: Bearer sk_test_..."

const item = await cord.quotes.retrieve('ID');

Respuesta: data

`id`	`string`	Identificador (UUID).
`folio`	`string`	Folio legible asignado por Cord, por ejemplo COT-0042.
`cliente`	`string \| null`	Cliente al que va dirigido: nombre de la empresa, o los datos para darlo de alta si no existe.
`status`	`string`	Estado de la cotización: draft, sent, viewed, approved, rejected, expired, paid o invoiced.
`total`	`number`	Importe en la divisa indicada por `moneda`.
`moneda`	`string \| null`	Divisa ISO 4217.
`terminos`	`string \| null`	Etiqueta legible del plazo en el idioma de la cuenta ("Contado", "Net 45"); para comparar usa terminos_codigo.
`terminos_codigo`	`string \| null`	Código estable del plazo: contado o net<N> (net7, net15, net30, net45, net60, net90).
`vigencia`	`string \| null`	Fecha ISO 8601.
`creada`	`string \| null`	Fecha ISO 8601.
`link_publico`	`string`	Link público absoluto de la cotización.
`language`	`"es" \| "en" \| "pt" \| "fr" \| "de" \| null`	Solo lectura. Idioma con que se envió: es, en, pt, fr o de. null mientras es borrador, que sigue el idioma del cliente.
`notas`	`string \| null`	Notas internas; el cliente no las ve.
`aprobacion`	`object \| null`	Aprobación interna requerida por una regla del negocio; null si no aplica.
`items`	`object[]`	Líneas.
`descuento`	`object \| null`	Descuento de documento, aplicado antes de impuestos y repartido entre las líneas; null si no hay. subtotal ya es neto.
`eventos`	`object[]`	Lista de eventos o tipos de evento. Vacía = todos.

POST`/api/v1/cotizaciones/{id}`

Enviar, reenviar, aprobar, rechazar o marcar pagadascope: write

Campo	Tipo	Descripción
`action` requerido	`"send" \| "resend" \| "approve" \| "reject" \| "mark_paid"`	Acción a ejecutar; cada una exige el estado previo correcto y es idempotente con Idempotency-Key.
`payment_method`	`string`	Método de pago al marcar pagada: transferencia, efectivo, tarjeta…

curl -X POST https://cordhq.app/api/v1/cotizaciones/ID \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"action":"send"}'

await cord.quotes.send('ID');

Respuesta: data

id string Identificador (UUID).

DELETE`/api/v1/cotizaciones/{id}`

Borrar un borradorscope: write

curl -X DELETE https://cordhq.app/api/v1/cotizaciones/ID \
  -H "Authorization: Bearer sk_test_..."

await cord.quotes.del('ID');

Respuesta: data

id string Identificador (UUID).

POST`/api/v1/cotizaciones/ia`

Proponer líneas a partir del texto de un pedidoscope: write

Campo	Tipo	Descripción
`texto` requerido	`string`	Texto libre del pedido.

curl -X POST https://cordhq.app/api/v1/cotizaciones/ia \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"texto":"…"}'

const { items } = await cord.quotes.draftFromText('5 sacos de cemento');

Respuesta: data

`items`	`any[]`	Líneas.
`moneda`	`string`	Divisa ISO 4217 de los importes.

Clientes

GET`/api/v1/clientes`

Listar clientesscope: readPaginación por offset

Parámetros: limit, offset, cursor, q, email

curl https://cordhq.app/api/v1/clientes \
  -H "Authorization: Bearer sk_test_..."

for await (const item of cord.clients.listAll()) {
  console.log(item.id);
}

Respuesta: data[]

`id`	`string`	Identificador (UUID).
`empresa`	`string`	Nombre de la empresa o persona.
`contacto`	`string`	Nombre de la persona de contacto.
`email`	`string`	Correo electrónico.
`telefono`	`string`	Teléfono con lada internacional.
`rfc`	`string`	Identificador fiscal: RFC, NIF, EIN…
`terminos`	`string`	Etiqueta legible de los términos.
`terminosCode`	`string`	Código de términos de pago: contado o net<N> (net7, net15, net30, net45, net60, net90).
`limite`	`number`	Límite de crédito del cliente, en la divisa del negocio.
`nivel`	`string`	Nivel o segmento del cliente.
`descuentoPct`	`number`	Descuento por defecto del cliente, en porcentaje.
`regimenFiscal`	`string`	Clave de régimen fiscal del SAT (México).
`usoCfdi`	`string`	Clave de uso de CFDI (México).
`cpFiscal`	`string`	Código postal del domicilio fiscal (México).
`countryCode`	`string`	País ISO 3166-1 alfa-2.
`language`	`"es" \| "en" \| "pt" \| "fr" \| "de" \| null`	Idioma de los documentos que recibe el cliente: es, en, pt, fr o de; null = el de la organización. Cotizaciones y facturas guardan el idioma con que se enviaron o emitieron; cambiarlo no reescribe lo ya enviado. Otro valor responde 400 con field: language.

POST`/api/v1/clientes`

Crear clientescope: write

Campo	Tipo	Descripción
`empresa` requerido	`string`	Nombre de la empresa o persona.
`language`	`"es" \| "en" \| "pt" \| "fr" \| "de" \| null`	Idioma de los documentos que recibe el cliente: es, en, pt, fr o de; null = el de la organización. Cotizaciones y facturas guardan el idioma con que se enviaron o emitieron; cambiarlo no reescribe lo ya enviado. Otro valor responde 400 con field: language.

curl -X POST https://cordhq.app/api/v1/clientes \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"empresa":"…"}'

const created = await cord.clients.create({
  "empresa": "…"
});

Respuesta: data

id string Identificador (UUID).

GET`/api/v1/clientes/{id}`

Detalle de clientescope: read

curl https://cordhq.app/api/v1/clientes/ID \
  -H "Authorization: Bearer sk_test_..."

const item = await cord.clients.retrieve('ID');

Respuesta: data

`id`	`string`	Identificador (UUID).
`empresa`	`string`	Nombre de la empresa o persona.
`contacto`	`string`	Nombre de la persona de contacto.
`email`	`string`	Correo electrónico.
`telefono`	`string`	Teléfono con lada internacional.
`rfc`	`string`	Identificador fiscal: RFC, NIF, EIN…
`terminos`	`string`	Etiqueta legible de los términos.
`terminosCode`	`string`	Código de términos de pago: contado o net<N> (net7, net15, net30, net45, net60, net90).
`limite`	`number`	Límite de crédito del cliente, en la divisa del negocio.
`nivel`	`string`	Nivel o segmento del cliente.
`descuentoPct`	`number`	Descuento por defecto del cliente, en porcentaje.
`regimenFiscal`	`string`	Clave de régimen fiscal del SAT (México).
`usoCfdi`	`string`	Clave de uso de CFDI (México).
`cpFiscal`	`string`	Código postal del domicilio fiscal (México).
`countryCode`	`string`	País ISO 3166-1 alfa-2.
`language`	`"es" \| "en" \| "pt" \| "fr" \| "de" \| null`	Idioma de los documentos que recibe el cliente: es, en, pt, fr o de; null = el de la organización. Cotizaciones y facturas guardan el idioma con que se enviaron o emitieron; cambiarlo no reescribe lo ya enviado. Otro valor responde 400 con field: language.

PATCH`/api/v1/clientes/{id}`

Actualizar datos de contactoscope: write

Campo	Tipo	Descripción
`language`	`"es" \| "en" \| "pt" \| "fr" \| "de" \| null`	Idioma de los documentos que recibe el cliente: es, en, pt, fr o de; null = el de la organización. Cotizaciones y facturas guardan el idioma con que se enviaron o emitieron; cambiarlo no reescribe lo ya enviado. Otro valor responde 400 con field: language.

curl -X PATCH https://cordhq.app/api/v1/clientes/ID \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{}'

await cord.clients.update('ID', { email: 'compras@acme.mx' });

Respuesta: data

id string Identificador (UUID).

Productos

GET`/api/v1/productos`

Listar productosAcepta pk_scope: readPaginación por offset

Parámetros: limit, offset, cursor

curl https://cordhq.app/api/v1/productos \
  -H "Authorization: Bearer sk_test_..."

for await (const item of cord.products.listAll()) {
  console.log(item.id);
}

Respuesta: data[]

`id`	`string`	Identificador (UUID).
`sku`	`string`	Código interno del producto.
`nombre`	`string`	Nombre.
`unidad`	`string`	Unidad de medida: pieza, kg, hora…
`descripcion`	`string`	Descripción tal como la ve el cliente.
`precio`	`number`	Importe en la divisa indicada por `moneda`.
`costo`	`number`	Nunca se expone a una llave publicable.
`activo`	`boolean`	false si está desactivado: se conserva pero no se usa.
`createdAt`	`string \| null`	Fecha ISO 8601.
`preciosVolumen`	`object[]`	Precios escalonados por cantidad.
`existencias`	`number \| null`	Unidades disponibles; null si no se lleva inventario.
`taxRate`	`number \| null`	Impuesto que se sugiere al agregar el producto a una línea, como fracción 0–1; null = el predeterminado de la organización.
`claveSat`	`string \| null`	Clave de producto o servicio del SAT (c_ClaveProdServ, 8 dígitos) para el CFDI en México; null si no se clasificó.
`claveUnidadSat`	`string \| null`	Clave de unidad del SAT (c_ClaveUnidad, como H87 o E48) para el CFDI en México; null = se deduce de la unidad.

POST`/api/v1/productos`

Crear productoscope: write

Campo	Tipo	Descripción
`nombre` requerido	`string`	Nombre.

curl -X POST https://cordhq.app/api/v1/productos \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"nombre":"…"}'

const created = await cord.products.create({
  "nombre": "…"
});

Respuesta: data

id string Identificador (UUID).

Facturas

GET`/api/v1/facturas`

Listar facturasscope: readPaginación por cursor

Parámetros: limit, cursor, estado, cliente, desde, hasta, q

curl https://cordhq.app/api/v1/facturas \
  -H "Authorization: Bearer sk_test_..."

for await (const item of cord.invoices.listAll()) {
  console.log(item.id);
}

Respuesta: data[]

`id`	`string`	Identificador (UUID).
`numero`	`string \| null`	Número de la factura en su serie.
`folio_fiscal`	`string \| null`	Identificador ante la autoridad fiscal (UUID del CFDI en México); null si no aplica.
`cliente`	`string \| null`	Cliente al que va dirigido: nombre de la empresa, o los datos para darlo de alta si no existe.
`estado`	`string`	draft, open, paid, void o uncollectible.
`estado_fiscal`	`string`	Estado de la emisión: pending, issued, cancelled o error.
`pais`	`string`	País ISO 3166-1 alfa-2.
`tipo`	`string`	Tipo de documento: cfdi_40, cfdi_egreso, proforma, commercial_invoice, commercial_credit_note, verifactu_invoice o verifactu_credit_note.
`documento`	`"factura" \| "factura_proforma" \| "nota_credito" \| "nota_debito"`	Cómo se titula el documento. factura_proforma no es una factura ni tiene validez fiscal: el tipo proforma y, en España, todo documento sin registro de Verifactu.
`moneda`	`string \| null`	Divisa ISO 4217.
`total`	`number`	Importe en la divisa indicada por `moneda`.
`pagado`	`number`	Importe en la divisa indicada por `moneda`.
`saldo`	`number`	Importe en la divisa indicada por `moneda`.
`vence`	`string \| null`	Fecha ISO 8601.
`vencida`	`boolean`	true si pasó la fecha de vencimiento con saldo pendiente.
`cotizacion_id`	`string \| null`	ID de la cotización relacionada.
`creada`	`string \| null`	Fecha ISO 8601.
`language`	`"es" \| "en" \| "pt" \| "fr" \| "de" \| null`	Solo lectura. Idioma con que se emitió: es, en, pt, fr o de. null mientras es borrador.

POST`/api/v1/facturas`

Crear factura en borradorscope: write

Campo	Tipo	Descripción
`cliente_id` requerido	`string`	ID de un cliente del directorio.
`items` requerido	`object[]`	Líneas.
`currency`	`string`	Divisa ISO 4217.
`due_date`	`string`	Fecha de vencimiento, YYYY-MM-DD.
`service_date`	`string`	Fecha de prestación del servicio o de entrega (Leistungsdatum), YYYY-MM-DD. Sin ella, la factura indica que coincide con la fecha de emisión.
`service_date_end`	`string`	Fin del periodo de prestación, YYYY-MM-DD. Requiere service_date y no puede ser anterior.
`notas`	`string`	Notas internas; el cliente no las ve.
`iva_incluido`	`boolean`	true si los precios capturados ya incluyen el impuesto.
`document_mode`	`"commercial" \| "fiscal"`	commercial o fiscal. Sin él, fiscal si el plan lo incluye y el país lo tiene habilitado; fiscal sin eso responde 400.
`fx_buffer_pct`	`number`	Cobertura en puntos porcentuales sobre el tipo de cambio de referencia (2 = +2%); se acota a 25. Default 0.
`descuento`	`object \| null`	Descuento de documento antes de impuestos, repartido entre las líneas en proporción a su importe. Cord calcula el monto; null lo quita.
`cupon`	`string`	Código de un cupón del negocio. Cord valida vigencia, divisa y usos; si viene, manda sobre descuento. Es el único descuento que admite una llave publicable.
`buyer_reference`	`string`	Referencia del comprador para su cuenta por pagar (en Alemania, el Leitweg-ID de la administración pública). La lleva la factura electrónica europea (BT-10) y la exige XRechnung. Sin ella, la del cliente. Si la dirección electrónica del cliente es un Leitweg-ID (esquema 0204), se comprueban sus dígitos de control (ISO/IEC 7064 MOD 97-10) y una que no pase responde 400.
`purchase_order`	`string`	Número de la orden de compra del cliente (BT-13 de la factura electrónica europea).

curl -X POST https://cordhq.app/api/v1/facturas \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"cliente_id":"…","items":[{"descripcion":"…","cantidad":1,"precio_unitario":1}]}'

const created = await cord.invoices.create({
  "cliente_id": "…",
  "items": [
    {
      "descripcion": "…",
      "cantidad": 1,
      "precio_unitario": 1
    }
  ]
});

Respuesta: data

id string Identificador (UUID).

GET`/api/v1/facturas/{id}`

Detalle de facturascope: read

curl https://cordhq.app/api/v1/facturas/ID \
  -H "Authorization: Bearer sk_test_..."

const item = await cord.invoices.retrieve('ID');

Respuesta: data

`id`	`string`	Identificador (UUID).
`numero`	`string \| null`	Número de la factura en su serie.
`folio_fiscal`	`string \| null`	Identificador ante la autoridad fiscal (UUID del CFDI en México); null si no aplica.
`cliente`	`string \| null`	Cliente al que va dirigido: nombre de la empresa, o los datos para darlo de alta si no existe.
`estado`	`string`	draft, open, paid, void o uncollectible.
`estado_fiscal`	`string`	Estado de la emisión: pending, issued, cancelled o error.
`pais`	`string`	País ISO 3166-1 alfa-2.
`tipo`	`string`	Tipo de documento: cfdi_40, cfdi_egreso, proforma, commercial_invoice, commercial_credit_note, verifactu_invoice o verifactu_credit_note.
`documento`	`"factura" \| "factura_proforma" \| "nota_credito" \| "nota_debito"`	Cómo se titula el documento. factura_proforma no es una factura ni tiene validez fiscal: el tipo proforma y, en España, todo documento sin registro de Verifactu.
`moneda`	`string \| null`	Divisa ISO 4217.
`total`	`number`	Importe en la divisa indicada por `moneda`.
`pagado`	`number`	Importe en la divisa indicada por `moneda`.
`saldo`	`number`	Importe en la divisa indicada por `moneda`.
`vence`	`string \| null`	Fecha ISO 8601.
`vencida`	`boolean`	true si pasó la fecha de vencimiento con saldo pendiente.
`cotizacion_id`	`string \| null`	ID de la cotización relacionada.
`creada`	`string \| null`	Fecha ISO 8601.
`language`	`"es" \| "en" \| "pt" \| "fr" \| "de" \| null`	Solo lectura. Idioma con que se emitió: es, en, pt, fr o de. null mientras es borrador.
`subtotal`	`number`	Importe en la divisa indicada por `moneda`.
`impuestos`	`number`	Importe en la divisa indicada por `moneda`.
`moneda_contable`	`string \| null`	Divisa ISO 4217.
`tipo_cambio`	`number \| null`	Tipo de cambio declarado de la divisa de venta a la contable; null si son la misma.
`total_contable`	`number \| null`	Total convertido a la divisa contable.
`notas`	`string \| null`	Notas internas; el cliente no las ve.
`nota_credito_de`	`string \| null`	ID de la factura que corrige esta nota de crédito.
`emisor`	`any`	Datos fiscales de quien emite.
`receptor`	`any`	Datos fiscales del cliente que recibe la factura.
`descuento`	`object \| null`	Descuento de documento, aplicado antes de impuestos y repartido entre las líneas; null si no hay. subtotal ya es neto.
`conceptos`	`object[]`	Líneas de la factura con su impuesto.
`pagos`	`object[]`	Pagos recibidos.

POST`/api/v1/facturas/{id}`

Emitir, enviar, anular, registrar pago o nota de créditoscope: write

Campo	Tipo	Descripción
`action` requerido	`"finalize" \| "send" \| "void" \| "payment" \| "credit_note"`	Acción a ejecutar; cada una exige el estado previo correcto y es idempotente con Idempotency-Key.
`monto`	`number`	Importe en la divisa indicada por moneda.
`moneda`	`string`	Divisa ISO 4217 de los importes.
`metodo`	`string`	Método de pago: transferencia, efectivo, tarjeta…
`referencia`	`string`	Referencia del pago o del proveedor.
`motivo`	`string`	Razón, escrita por una persona.
`sin_comercio_exterior`	`boolean`	México, al emitir (finalize): true confirma que un CFDI con mercancías para un cliente en el extranjero no es una exportación definitiva. Sin él, esa emisión responde 409 con el código comercio_exterior, porque Cord no genera el complemento de comercio exterior.

curl -X POST https://cordhq.app/api/v1/facturas/ID \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"action":"finalize"}'

await cord.invoices.finalize('ID');

Respuesta: data

id string Identificador (UUID).

Cobranza

GET`/api/v1/cobranza`

Cartera por cobrarscope: read

curl https://cordhq.app/api/v1/cobranza \
  -H "Authorization: Bearer sk_test_..."

const cartera = await cord.collections.retrieve();

Respuesta: data

`resumen`	`any`	Totales de un vistazo.
`aging`	`any`	Cartera por antigüedad en cuatro cubetas fijas: vigente (por vencer), d30 (1-30 días vencida), d60 (31-60) y d60p (más de 60). Cada una trae key, label, monto y n.
`items`	`any[]`	Líneas.
`clientes`	`any`	Saldo agrupado por cliente.

Eventos

GET`/api/v1/events`

Historial de eventosscope: readPaginación por cursor

Parámetros: limit, cursor, type, object_id

curl https://cordhq.app/api/v1/events \
  -H "Authorization: Bearer sk_test_..."

for await (const item of cord.events.listAll()) {
  console.log(item.id);
}

Respuesta: data[]

`id`	`string`	Identificador (UUID).
`type`	`string`	Tipo de evento, por ejemplo quote.approved.
`object`	`string`	Tipo de objeto: quote, invoice, client, product, task, promise…
`object_id`	`string \| null`	ID del objeto al que se refiere.
`data`	`object`	Contenido de la respuesta o del evento.
`actor`	`string \| null`	Quién lo hizo: user, api, mcp, client (el destinatario del link público) o system.
`created_at`	`string`	Fecha de creación, ISO 8601.

Tareas

POST`/api/v1/tareas`

Crear tareascope: write

Campo	Tipo	Descripción
`titulo` requerido	`string`	Qué hay que hacer.
`due_date`	`string`	Fecha de vencimiento, YYYY-MM-DD.
`cotizacion_id`	`string`	ID de la cotización relacionada.
`factura_id`	`string`	ID de la factura relacionada (el `id` de /facturas).

curl -X POST https://cordhq.app/api/v1/tareas \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"titulo":"…"}'

await cord.tasks.create({ titulo: 'Llamar a Acme' });

Respuesta: data

id string Identificador (UUID).

Workflows

POST`/api/v1/workflows/{id}/invoke`

Correr un workflow "Lo corres tú" sobre cotizaciones o facturasscope: write

Campo	Tipo	Descripción
`objeto` requerido	`"quote" \| "invoice"`	Tipo de documento: quote (cotización) o invoice (factura); debe coincidir con el disparador del workflow.
`ids` requerido	`string[]`	Identificadores (UUID) de los documentos, de 1 a 50.

curl -X POST https://cordhq.app/api/v1/workflows/ID/invoke \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"objeto":"quote","ids":["…"]}'

Respuesta: data

`documentos`	`number`	Cuántos de los documentos enviados existen en la organización.
`corridas`	`number`	Cuántas ejecuciones empezaron: un documento que no cumple el filtro del workflow o que ya entró antes no cuenta.

Webhooks

GET`/api/v1/webhooks`

Endpoints creados por esta llavescope: read

curl https://cordhq.app/api/v1/webhooks \
  -H "Authorization: Bearer sk_test_..."

const items = await cord.webhookEndpoints.list();

Respuesta: data

`id`	`string`	Identificador (UUID).
`url`	`string`	URL HTTPS que recibe los eventos.
`eventos`	`string[]`	Lista de eventos o tipos de evento. Vacía = todos.
`activo`	`boolean`	false si está desactivado: se conserva pero no se usa.
`created_at`	`string`	Fecha de creación, ISO 8601.

POST`/api/v1/webhooks`

Crear endpoint (el secreto se devuelve una vez)scope: write

Campo	Tipo	Descripción
`url` requerido	`string`	URL HTTPS que recibe los eventos.
`eventos`	`string[]`	Lista de eventos o tipos de evento. Vacía = todos.

curl -X POST https://cordhq.app/api/v1/webhooks \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"url":"…"}'

const created = await cord.webhookEndpoints.create({
  "url": "…"
});

Respuesta: data

`id`	`string`	Identificador (UUID).
`url`	`string`	URL HTTPS que recibe los eventos.
`eventos`	`string[]`	Lista de eventos o tipos de evento. Vacía = todos.
`activo`	`boolean`	false si está desactivado: se conserva pero no se usa.
`created_at`	`string`	Fecha de creación, ISO 8601.
`secret`	`string`	Secreto para verificar la firma. Solo se muestra una vez.

DELETE`/api/v1/webhooks/{id}`

Borrar endpointscope: write

curl -X DELETE https://cordhq.app/api/v1/webhooks/ID \
  -H "Authorization: Bearer sk_test_..."

await cord.webhookEndpoints.del('ID');

Respuesta: data

id string Identificador (UUID).

Elements

GET`/api/v1/elements/config`

Configuración que dibuja Cord ElementsAcepta pk_scope: read

curl https://cordhq.app/api/v1/elements/config \
  -H "Authorization: Bearer sk_test_..."

const config = await cord.elements.config();

Respuesta: data

`object`	`"elements_config"`	Tipo de objeto: quote, invoice, client, product, task, promise…
`org`	`object`	Organización dueña de la llave.
`monedas`	`string[]`	Divisas que el negocio ofrece al cotizar.
`impuestos`	`object`	Impuestos del documento o catálogo de impuestos.
`terminos`	`"contado" \| "net7" \| "net15" \| "net30" \| "net45" \| "net60" \| "net90"[]`	Términos de pago: contado o net<N> (N días de crédito: 7, 15, 30, 45, 60 o 90).
`terminos_default`	`"contado" \| "net7" \| "net15" \| "net30" \| "net45" \| "net60" \| "net90"`	Términos de pago por defecto.
`vigencia_dias_default`	`number`	Vigencia por defecto, en días.
`fiscal`	`object`	Datos fiscales.

POST`/api/v1/elements/ai-draft`

Líneas con IA en streaming (text/event-stream)Acepta pk_scope: write

Campo	Tipo	Descripción
`texto`	`string`	Texto libre del pedido.
`archivo`	`string`	JPG, PNG o PDF, máx 4 MB.

curl -X POST https://cordhq.app/api/v1/elements/ai-draft \
  -H "Authorization: Bearer sk_test_..." \
  -F "texto=5 sacos de cemento y 2 de arena"

Responde text/event-stream con eventos item, done y error.

Modo prueba

POST`/api/v1/test_helpers/fiscal`

Forzar el resultado de la próxima emisiónSolo sk_test_scope: write

Campo	Tipo	Descripción
`siguiente_resultado` requerido	`"exito" \| "pac_caido" \| "receptor_invalido" \| "certificado_vencido" \| "timbre_duplicado"`	Resultado que tendrá la próxima emisión fiscal de la sandbox.

curl -X POST https://cordhq.app/api/v1/test_helpers/fiscal \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"siguiente_resultado":"exito"}'

await cord.testHelpers.fiscal.setNextOutcome('pac_caido');

Respuesta: data

siguiente_resultado string Resultado que tendrá la próxima emisión fiscal de la sandbox.

POST`/api/v1/test_helpers/cotizaciones/{id}`

Simular apertura o vencimientoSolo sk_test_scope: write

Campo	Tipo	Descripción
`accion` requerido	`"vista" \| "vencer"`	Qué simular: vista (el cliente abre el link) o vencer (la cotización vence).

curl -X POST https://cordhq.app/api/v1/test_helpers/cotizaciones/ID \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"accion":"vista"}'

await cord.testHelpers.quotes.expire('ID');

Respuesta: data

id string Identificador (UUID).

POST`/api/v1/test_helpers/webhooks`

Disparar un webhookSolo sk_test_scope: write

Campo	Tipo	Descripción
`evento` requerido	`string`	Tipo de evento, por ejemplo quote.approved.
`objeto_id`	`string`	ID de una cotización o factura de la sandbox; sin él se usan datos de ejemplo.

curl -X POST https://cordhq.app/api/v1/test_helpers/webhooks \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{"evento":"…"}'

await cord.testHelpers.webhooks.trigger('invoice.paid');

Respuesta: data

`evento`	`string`	Tipo de evento, por ejemplo quote.approved.
`datos`	`"real" \| "ejemplo"`	real si se usaron los datos del objeto indicado; ejemplo si se inventaron.

POST`/api/v1/test_helpers/listen`

Abrir sesión de cord listenSolo sk_test_scope: write

Campo	Tipo	Descripción
`eventos`	`string[]`	Lista de eventos o tipos de evento. Vacía = todos.

curl -X POST https://cordhq.app/api/v1/test_helpers/listen \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{}'

Respuesta: data

`id`	`string`	Identificador (UUID).
`secret`	`string`	Secreto para verificar la firma. Solo se muestra una vez.
`eventos`	`string[]`	Lista de eventos o tipos de evento. Vacía = todos.
`expira`	`string`	Fecha de vencimiento, ISO 8601.

GET`/api/v1/test_helpers/listen/{id}`

Recoger eventos de la sesiónSolo sk_test_scope: write

curl https://cordhq.app/api/v1/test_helpers/listen/ID \
  -H "Authorization: Bearer sk_test_..."

Respuesta: data

`event_id`	`string`	ID del evento; deduplica por él.
`evento`	`string`	Tipo de evento, por ejemplo quote.approved.
`body`	`string`	Cuerpo crudo del evento; reenvíalo sin modificar para que la firma valide.
`headers`	`object`	Headers a reenviar tal cual, incluida la firma X-Cord-Signature-V1.

DELETE`/api/v1/test_helpers/listen/{id}`

Cerrar sesión de cord listenSolo sk_test_scope: write

curl -X DELETE https://cordhq.app/api/v1/test_helpers/listen/ID \
  -H "Authorization: Bearer sk_test_..."

Respuesta: data

id string Identificador (UUID).

Configuración

POST`/api/v1/setup/plans`

Proponer una configuración de la cuenta (una persona la aprueba en review_url)scope: write

Campo	Tipo	Descripción
`sitio`	`string`	Sitio web del negocio, por ejemplo tunegocio.com.
`descripcion`	`string`	Descripción del negocio: giro, plazos de pago, impuestos que cobra o retiene.
`archivo`	`object`	Lista de precios (Excel, CSV, PDF o foto) en base64, hasta 3 MB.

curl -X POST https://cordhq.app/api/v1/setup/plans \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json" \
  -d '{}'

Respuesta: data

`object`	`"setup_plan"`	Tipo de objeto: quote, invoice, client, product, task, promise…
`id`	`string`	Identificador (UUID).
`estado`	`"generando" \| "propuesto" \| "aplicado" \| "descartado" \| "fallido"`	propuesto espera la aprobación de una persona en review_url.
`review_url`	`string`	Página donde una persona con sesión revisa y aplica la propuesta. La API nunca la aplica.

GET`/api/v1/setup/plans/{id}`

Estado de una propuesta de configuraciónscope: read

curl https://cordhq.app/api/v1/setup/plans/ID \
  -H "Authorization: Bearer sk_test_..."

Respuesta: data

`object`	`"setup_plan"`	Tipo de objeto: quote, invoice, client, product, task, promise…
`id`	`string`	Identificador (UUID).
`estado`	`"generando" \| "propuesto" \| "aplicado" \| "descartado" \| "fallido"`	propuesto espera la aprobación de una persona en review_url.
`review_url`	`string`	Página donde una persona con sesión revisa y aplica la propuesta. La API nunca la aplica.

Cuenta

GET/api/v1/me

Cotizaciones

GET/api/v1/cotizaciones

POST/api/v1/cotizaciones

GET/api/v1/cotizaciones/{id}

POST/api/v1/cotizaciones/{id}

DELETE/api/v1/cotizaciones/{id}

POST/api/v1/cotizaciones/ia

Clientes

GET/api/v1/clientes

POST/api/v1/clientes

GET/api/v1/clientes/{id}

PATCH/api/v1/clientes/{id}

Productos

GET/api/v1/productos

POST/api/v1/productos

Facturas

GET/api/v1/facturas

POST/api/v1/facturas

GET/api/v1/facturas/{id}

POST/api/v1/facturas/{id}

Cobranza

GET/api/v1/cobranza

Eventos

GET/api/v1/events

Tareas

POST/api/v1/tareas

Workflows

POST/api/v1/workflows/{id}/invoke

Webhooks

GET/api/v1/webhooks

POST/api/v1/webhooks

DELETE/api/v1/webhooks/{id}

Elements

GET/api/v1/elements/config

POST/api/v1/elements/ai-draft

Modo prueba

POST/api/v1/test_helpers/fiscal

POST/api/v1/test_helpers/cotizaciones/{id}

POST/api/v1/test_helpers/webhooks

POST/api/v1/test_helpers/listen

GET/api/v1/test_helpers/listen/{id}

DELETE/api/v1/test_helpers/listen/{id}

Configuración

POST/api/v1/setup/plans

GET/api/v1/setup/plans/{id}

GET`/api/v1/me`

GET`/api/v1/cotizaciones`

POST`/api/v1/cotizaciones`

GET`/api/v1/cotizaciones/{id}`

POST`/api/v1/cotizaciones/{id}`

DELETE`/api/v1/cotizaciones/{id}`

POST`/api/v1/cotizaciones/ia`

GET`/api/v1/clientes`

POST`/api/v1/clientes`

GET`/api/v1/clientes/{id}`

PATCH`/api/v1/clientes/{id}`

GET`/api/v1/productos`

POST`/api/v1/productos`

GET`/api/v1/facturas`

POST`/api/v1/facturas`

GET`/api/v1/facturas/{id}`

POST`/api/v1/facturas/{id}`

GET`/api/v1/cobranza`

GET`/api/v1/events`

POST`/api/v1/tareas`

POST`/api/v1/workflows/{id}/invoke`

GET`/api/v1/webhooks`

POST`/api/v1/webhooks`

DELETE`/api/v1/webhooks/{id}`

GET`/api/v1/elements/config`

POST`/api/v1/elements/ai-draft`

POST`/api/v1/test_helpers/fiscal`

POST`/api/v1/test_helpers/cotizaciones/{id}`

POST`/api/v1/test_helpers/webhooks`

POST`/api/v1/test_helpers/listen`

GET`/api/v1/test_helpers/listen/{id}`

DELETE`/api/v1/test_helpers/listen/{id}`

POST`/api/v1/setup/plans`

GET`/api/v1/setup/plans/{id}`