Quickstart

import crypto from 'node:crypto'

const baseUrl = 'https://sandbox-api.cobrix.co/api'
const companyId = process.env.COBRIX_COMPANY_ID
const secret = process.env.COBRIX_API_KEY
const path = `/integrations/v1/${companyId}/customers/upsert`
const body = JSON.stringify({
  source: 'erp_acme',
  externalCustomerId: 'customer-1001',
  type: 'individual',
  name: 'Cliente de prueba',
  email: '[email protected]'
})
const timestamp = Math.floor(Date.now() / 1000).toString()
const signed = `${timestamp}.POST.${path}.${body}`
const signature = crypto.createHmac('sha256', secret).update(signed).digest('hex')

const response = await fetch(`${baseUrl}${path}`, {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${secret}`,
    'Content-Type': 'application/json',
    'Idempotency-Key': crypto.randomUUID(),
    'Cobrix-Timestamp': timestamp,
    'Cobrix-Signature': `v1=${signature}`
  },
  body
})

console.log(response.status, await response.json())

curl --request POST "https://sandbox-api.cobrix.co/api/v1/invoices" \
  --header "Authorization: Bearer $COBRIX_API_KEY" \
  --header "Content-Type: application/json" \
  --header "x-idempotency: $(uuidgen)" \
  --data '{
    "reference": "INV-EXT-1001",
    "provider": "erp_acme",
    "provider_id": "1001",
    "amount": 20.25,
    "name": "Plan mensual de internet",
    "email": "[email protected]",
    "due_date": "2026-08-15"
  }'