Empezar con la API de Vertex

Requisitos previos

Una cuenta activa en Vertex con rol de Administrador
Acceso a Configuración > Llaves y Credenciales > pestaña API & Developer

Paso 1: Genera tu API Key

1. En el menú lateral, abre Configuración > Llaves y Credenciales 2. Selecciona la pestaña API & Developer 3. Haz clic en + Nueva Key 4. Asigna un nombre descriptivo (ej: "Mi ERP") 5. Selecciona los permisos que necesitas 6. Copia la key — solo se muestra una vez

Paso 2: Haz tu primer request

bash
curl -X GET https://vertex.app/api/v1/invoices \
  -H "Authorization: Bearer vtx_tu_api_key_aqui" \
  -H "Content-Type: application/json"



Paso 3: Verifica la respuesta

json
{
  data: [
    {
      id: 'uuid-de-la-factura',
      internal_number: 'FEL-2026-000001',
      status: 'posted',
      total_amount: 1120.00,
      customer: {
        name: 'Empresa Demo',
        tax_id: '12345678'
      },
    }
  ],
  meta: {
    page: 1,
    per_page: 25,
    total: 1,
    total_pages: 1,
  }
}



Base URL

Todos los endpoints de la API pública usan como base:

https://vertex.app/api/v1



Formato de respuesta

Todas las respuestas exitosas siguen el formato:

json
{
  "data": { ... },
  "meta": { ... }
}



Los errores siguen el formato:

json
{
  error: {
    code: 'INVALID_SCOPE',
    message: 'Missing required scope: invoices:read'
  },
}

Siguiente paso

Consulta la referencia de la API de Facturas para ver todos los endpoints disponibles.