Referencia API

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/catalog',
  {
    method: 'GET',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      'x-istmo-commerce-key': process.env.ISTMO_COMMERCE_KEY
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/orders',
  {
    method: 'POST',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      'x-istmo-commerce-key': process.env.ISTMO_COMMERCE_KEY,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      "externalId": "web-7d2f4c9a",
      "customer": {
        "name": "María González",
        "email": "maria@example.com",
        "phone": "6000-1234"
      },
      "fulfillment": {
        "method": "pickup"
      },
      "lines": [
        {
          "productId": "11111111-1111-4111-8111-111111111111",
          "quantity": "2.0000"
        }
      ],
      "note": ""
    })
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/orders/web-7d2f4c9a',
  {
    method: 'GET',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      'x-istmo-commerce-key': process.env.ISTMO_COMMERCE_KEY
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/admin/integrations',
  {
    method: 'POST',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      Authorization: 'Bearer ' + process.env.ISTMO_ADMIN_TOKEN,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      "nombre": "Mi tienda",
      "sitioUrl": "https://tienda.example.com",
      "almacenId": "11111111-1111-4111-8111-111111111111",
      "numeroLista": 1,
      "scopes": [
        "catalog:read"
      ]
    })
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/admin/integrations',
  {
    method: 'GET',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      Authorization: 'Bearer ' + process.env.ISTMO_ADMIN_TOKEN
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/admin/integrations/11111111-1111-4111-8111-111111111111/rotate',
  {
    method: 'POST',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      Authorization: 'Bearer ' + process.env.ISTMO_ADMIN_TOKEN
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/admin/integrations/11111111-1111-4111-8111-111111111111',
  {
    method: 'DELETE',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      Authorization: 'Bearer ' + process.env.ISTMO_ADMIN_TOKEN
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/admin/integrations/11111111-1111-4111-8111-111111111111/products',
  {
    method: 'PUT',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      Authorization: 'Bearer ' + process.env.ISTMO_ADMIN_TOKEN,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      "productoIds": [
        "11111111-1111-4111-8111-111111111111"
      ]
    })
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/admin/integrations/11111111-1111-4111-8111-111111111111/products',
  {
    method: 'GET',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      Authorization: 'Bearer ' + process.env.ISTMO_ADMIN_TOKEN
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/admin/integrations/11111111-1111-4111-8111-111111111111/orders',
  {
    method: 'GET',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      Authorization: 'Bearer ' + process.env.ISTMO_ADMIN_TOKEN
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/admin/integrations/11111111-1111-4111-8111-111111111111/orders/11111111-1111-4111-8111-111111111111/reject',
  {
    method: 'POST',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      Authorization: 'Bearer ' + process.env.ISTMO_ADMIN_TOKEN,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      "motivo": "Producto sin disponibilidad"
    })
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/admin/options',
  {
    method: 'GET',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      Authorization: 'Bearer ' + process.env.ISTMO_ADMIN_TOKEN
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/admin/integrations/11111111-1111-4111-8111-111111111111/settings',
  {
    method: 'GET',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      Authorization: 'Bearer ' + process.env.ISTMO_ADMIN_TOKEN
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/admin/integrations/11111111-1111-4111-8111-111111111111/bridge',
  {
    method: 'PUT',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      Authorization: 'Bearer ' + process.env.ISTMO_ADMIN_TOKEN,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      "gatewayUrl": "https://tienda.example.com",
      "installationId": "11111111-1111-4111-8111-111111111111",
      "connectorKey": "Ejemplo",
      "localKey": "Ejemplo"
    })
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/admin/integrations/11111111-1111-4111-8111-111111111111/bridge',
  {
    method: 'DELETE',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      Authorization: 'Bearer ' + process.env.ISTMO_ADMIN_TOKEN
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/checkout-commands',
  {
    method: 'POST',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      'x-istmo-commerce-key': process.env.ISTMO_COMMERCE_KEY,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      "commandId": "11111111-1111-4111-8111-111111111111",
      "checkoutId": "web-7d2f4c9a",
      "action": "quote",
      "order": {
        "externalId": "web-7d2f4c9a",
        "customer": {
          "name": "María González",
          "email": "maria@example.com",
          "phone": "6000-1234"
        },
        "fulfillment": {
          "method": "pickup"
        },
        "lines": [
          {
            "productId": "11111111-1111-4111-8111-111111111111",
            "quantity": "2.0000"
          }
        ],
        "note": ""
      }
    })
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/checkout-commands/11111111-1111-4111-8111-111111111111',
  {
    method: 'GET',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      'x-istmo-commerce-key': process.env.ISTMO_COMMERCE_KEY
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/admin/integrations/11111111-1111-4111-8111-111111111111/payment-settings',
  {
    method: 'PUT',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      Authorization: 'Bearer ' + process.env.ISTMO_ADMIN_TOKEN,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      "enabled": false,
      "instrumentoId": "11111111-1111-4111-8111-111111111111",
      "instructions": "Ejemplo"
    })
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/admin/integrations/11111111-1111-4111-8111-111111111111/checkouts',
  {
    method: 'GET',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      Authorization: 'Bearer ' + process.env.ISTMO_ADMIN_TOKEN
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/admin/integrations/11111111-1111-4111-8111-111111111111/checkouts/11111111-1111-4111-8111-111111111111/confirm-transfer',
  {
    method: 'POST',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      Authorization: 'Bearer ' + process.env.ISTMO_ADMIN_TOKEN,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      "amount": "Ejemplo",
      "reference": "Ejemplo",
      "reason": "Ejemplo"
    })
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/admin/integrations/11111111-1111-4111-8111-111111111111/checkouts/11111111-1111-4111-8111-111111111111/invoice',
  {
    method: 'POST',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      Authorization: 'Bearer ' + process.env.ISTMO_ADMIN_TOKEN,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      "terceroId": "11111111-1111-4111-8111-111111111111"
    })
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/admin/integrations/11111111-1111-4111-8111-111111111111/checkouts/11111111-1111-4111-8111-111111111111/record-refund',
  {
    method: 'POST',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      Authorization: 'Bearer ' + process.env.ISTMO_ADMIN_TOKEN,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      "amount": "Ejemplo",
      "reference": "Ejemplo",
      "reason": "Ejemplo"
    })
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/admin/integrations/11111111-1111-4111-8111-111111111111/customers',
  {
    method: 'GET',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      Authorization: 'Bearer ' + process.env.ISTMO_ADMIN_TOKEN
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/admin/integrations/11111111-1111-4111-8111-111111111111/checkouts/11111111-1111-4111-8111-111111111111/fulfillment',
  {
    method: 'POST',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      Authorization: 'Bearer ' + process.env.ISTMO_ADMIN_TOKEN,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      "commandId": "11111111-1111-4111-8111-111111111111",
      "status": "preparando",
      "note": ""
    })
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/webhook-deliveries',
  {
    method: 'GET',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      'x-istmo-commerce-key': process.env.ISTMO_COMMERCE_KEY
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.

// Node 20+ · ejecutar sólo en el servidor
const response = await fetch(
  process.env.ISTMO_COMMERCE_BASE_URL + '/webhook-deliveries/{eventId}/retry',
  {
    method: 'POST',
    redirect: 'error',
    signal: AbortSignal.timeout(10000),
    headers: {
      'x-istmo-commerce-key': process.env.ISTMO_COMMERCE_KEY
    }
  }
);
const result = await response.json();
if (!response.ok) throw new Error(result.error?.code);
// En un timeout, conservar externalId y consultar su estado.