Vender al exterior › Tienda propia

API de Boxfly+

Tu tienda propia, hecha con IA o a medida, vendiendo al exterior

Si armaste tu tienda con inteligencia artificial o te la hizo un programador, se conecta con la API de Boxfly: el mismo precio exacto en el checkout y las mismas ventas en tu panel que con Tiendanube o WooCommerce.

Conectar mi tienda ¿Mi tienda está lista?
API gratisSin contrato ni mínimo
Lista para la IAInstrucciones para Claude
REST en JSONCuatro llamadas
+200 paísesFuera de Argentina
Sepas o no programar

Dos caminos, el mismo resultado

Esta página sirve si armaste tu tienda charlando con la IA y también si programás todos los días.

Armé mi tienda con IA

No hace falta que entiendas de APIs. Te preparamos un texto con las instrucciones completas y tus claves.

  • Lo pegás en la conversación donde armaste tu tienda.
  • La IA revisa qué le falta a tu tienda y lo agrega.
  • Probás una cotización desde tu panel y listo.
Ver el paso a paso

Soy programador (o tengo uno)

Una API REST en JSON, con una clave pública para cotizar y una secreta para mandar ventas desde tu servidor.

  • Cotizar, mandar la venta, consultar y cancelar.
  • Ventas sin duplicados, por tu propio id de pedido.
  • Errores con un motivo claro, en castellano.
Ver la referencia
Antes de conectar

Lo que tu tienda tiene que tener para que funcione

La API calcula y registra envíos con los datos que le manda tu tienda. Si alguno de estos no existe, Boxfly no puede dar precio ni recibir la venta.

CatálogoPeso y medidas en cada producto

En kilos y centímetros, en cada producto y variante, vinculados a tu stock. Sin eso no hay precio.

CarritoPaís y código postal en el carrito

El comprador elige su país y escribe su código postal: con eso se pide la cotización.

CheckoutLos datos del destinatario

Nombre, documento (pasaporte o ID), teléfono, e-mail, país, provincia, ciudad, dirección y código postal.

PagoUn pago que avise al servidor

La venta se manda a Boxfly cuando está pagada: el medio de pago tiene que confirmárselo a tu servidor.

BackendUn servidor donde lleguen las órdenes

La clave secreta vive ahí. Si tu tienda no tiene, sirven funciones como Netlify, Vercel o Cloudflare.

Base de datosDonde se guarden los pedidos

Cada venta con su id, la cotización de Boxfly y, después, el número de seguimiento.

DespachoLa dirección de salida

Desde donde retiramos los paquetes. La guardás como remitente en tu cuenta de Boxfly.

MonedaPrecios en pesos o dólares

Boxfly cotiza en la misma moneda en la que están tus productos: pesos o dólares.

¿Tu tienda es sólo una página, sin servidor ni base de datos? Primero hay que sumarle esas piezas; si la hiciste con IA, se lo podés pedir en la misma conversación. Las instrucciones de Boxfly le explican a la IA qué necesita y le piden que te avise lo que falta.

Cómo funciona por dentro

De tu carrito a la puerta de tu cliente

Tu carrito cotiza

Con país, código postal y productos.

POST /quote
Boxfly responde

Precio, plazo y una referencia para guardar.

price · delivery_days
El comprador paga

Tu medio de pago le avisa a tu servidor.

aviso de pago
Tu servidor manda la venta

Llega a tu panel de Boxfly para confirmar.

POST /orders
Confirmás y despachamos

El seguimiento vuelve a tu tienda.

GET /orders/{id}
Clave pública: sólo cotiza, puede ir en la páginaClave secreta: sólo en tu servidor
Si la armaste con IA

Conectala en una conversación

Las instrucciones las escribimos para Claude, pero sirven para cualquier asistente o programador.

  1. 1
    Generá tus claves

    En tu panel, en Integraciones › API para tu tienda. La clave secreta se muestra una sola vez.

  2. 2
    Copiá las instrucciones

    En Configuración está el texto listo, con tus claves, tus dominios y tu recargo.

  3. 3
    Pegalas donde armaste tu tienda

    En la misma conversación con la IA, así conoce tu tienda. Si te la hizo un programador, mandáselas a él. La IA te avisa qué le falta a tu tienda y lo agrega.

  4. 4
    Probá la conexión

    Tocá "Probar una cotización" en tu panel y hacé una compra de prueba con una dirección del exterior. Si algo falla, el mensaje de error dice qué dato falta.

Para programadores

Una API simple, en JSON

La referencia completa, con tus claves ya puestas, está en tu panel. Esto es un adelanto de cómo se usa.

  • Dos claves. La pública sólo cotiza y puede ir en la página, limitada a tus dominios. La secreta manda ventas y va sólo en tu servidor: nunca en el navegador ni en el código de la página.
  • Unidades. Peso en kilos y medidas en centímetros, mayores a 0 en cada ítem.
  • Moneda. ARS o USD, la misma en la cotización y en la venta. El precio del envío vuelve en esa moneda.
  • Sin duplicados. La venta se reconoce por tu propio id de pedido: si reintentás, no se duplica.
  • Nunca un precio inventado. Si la cotización responde ok: false, no muestres la opción de Boxfly.
  • Uso responsable. Hay un límite de consultas por minuto. Consultá el seguimiento sólo cuando el comprador abre su pedido.
POST /quote · clave pública
{
  "currency": "USD",
  "destination": { "country": "US", "postal_code": "33126", "city": "Miami" },
  "items": [
    { "name": "Cartera de cuero", "quantity": 1, "unit_price": 180,
      "weight_kg": 0.8, "length_cm": 35, "width_cm": 25, "height_cm": 12 }
  ]
}
200 respuesta
{
  "ok": true, "service": "Envío internacional Boxfly",
  "currency": "USD", "price": 38.00, "delivery_days": { "min": 3, "max": 7 },
  "quote_id": "…"   // guardalo junto a la venta
}
Ficha técnica

En resumen

GratisLa API, sin contrato ni mínimo de envíos
JSONUna API REST simple
+200Países de destino
3 a 7Días hábiles estimados, según el país de destino
Seguridad

Clave pública limitada a tus dominios y clave secreta sólo en tu servidor. Si una clave se filtra, la regenerás desde tu panel.

Moneda

Pesos o dólares, en la misma moneda en la que están tus productos.

Qué incluye el precio

Impuestos de exportación e IVA de Argentina, flete internacional, seguro y tu recargo.

Seguimiento

Una página de Boxfly en el idioma del país de destino, para mostrar en "Mis pedidos".

Tu panel

Ventas recibidas, últimas consultas de precio y una prueba de cotización.

Instrucciones listas

Un texto con todo para pegarle a Claude o mandarle a tu programador.

Avión de carga siendo cargado en la pista
Para tiendas que ya venden afuera

¿Tu tienda propia despacha seguido al exterior?

Hablemos de tu volumen

Si enviás al exterior todas las semanas, te asignamos un asesor y armamos tarifas según tu volumen de envíos.

  • Un asesor para tu tienda
  • Tarifas según tu volumen
  • Ayuda con la conexión
Hablar con un asesor
Empezá hoy

Conectá tu tienda propia con Boxfly

Para conectar cualquier integración necesitás una cuenta de Boxfly. Es gratis y te lleva un par de minutos.

Todavía no tengo cuenta

Creá tu cuenta gratis. Cuando la confirmes e inicies sesión, te llevamos directo a la sección API para tu tienda, donde generás tus claves.

  1. Completá tus datos y creá la cuenta.
  2. Confirmala desde el e-mail que te mandamos.
  3. Iniciá sesión en este mismo navegador y seguí con la conexión.
Crear mi cuenta gratis

Ya tengo cuenta de Boxfly

Iniciá sesión y entrás directo a la sección API para tu tienda, donde generás tus claves, en la sección Integraciones de tu panel.

  1. Ingresá con tu e-mail y tu contraseña.
  2. Te llevamos a la integración que elegiste.
  3. Seguí los pasos de esta página.
Iniciar sesión y conectar

¿Preferís que te acompañemos? Escribinos por WhatsApp

Resolvemos tus dudas

Preguntas frecuentes

Lo que más nos preguntan antes de conectar tu tienda propia.

Sí, si tu tienda la armaste con IA. Copiás las instrucciones de tu panel y se las pegás en la conversación donde la armaste: la IA hace la conexión y te avisa qué le falta a tu tienda. Si te trabás, te acompañamos por WhatsApp.

La clave secreta no puede ir en el navegador. Si tu tienda no tiene servidor, se usa una función del lado del servidor, como Netlify Functions, Vercel o Cloudflare Workers. Las instrucciones ya se lo explican a la IA.

Porque el precio del envío sale del peso, las medidas y el destino. Si un producto del carrito no los tiene, Boxfly no puede dar precio y la opción no aparece: nunca mostramos un precio inventado.

Generá una nueva desde tu panel: la anterior deja de funcionar en el momento. Después actualizala en tu servidor.

Sí. Configurá un recargo sobre el envío en tu panel: el precio que devuelve la API ya lo incluye y la diferencia es para vos.

Nada. La API es gratis, sin contrato ni mínimo de envíos. El envío internacional lo paga tu comprador al hacer la compra.

No sé programar, ¿puedo conectarla igual?

Sí, si tu tienda la armaste con IA. Copiás las instrucciones de tu panel y se las pegás en la conversación donde la armaste: la IA hace la conexión y te avisa qué le falta a tu tienda. Si te trabás, te acompañamos por WhatsApp.

¿Te quedó otra duda? Escribinos por WhatsApp
¿Otra duda? Escribinos por WhatsApp
Contacto

¿Tenés alguna duda?

Contanos qué necesitás y un asesor te responde dentro de las próximas 24 horas hábiles.

Consulta sin compromiso
¿Preferís hablar ahora? Te atendemos por WhatsApp o en una reunión si sos empresa.
Escribinos por WhatsApp Agendá una reunión