Usar la integracion API para sistemas propios - Integraciones

Usar la integracion API para sistemas propios - Integraciones | AutoLetter Help Center

Con la integracion API puedes transferir pedidos directamente desde tu propio sistema a AutoLetter. Esto es ideal para desarrollos propios, sistemas de tienda individuales o flujos de trabajo automatizados que no se pueden cubrir con las integraciones estandar (Billbee, Shopify).

Crear integracion

Navega a Integraciones, haz clic en Anadir y selecciona API como tipo de integracion.

Nombrar la integracion

Asigna un nombre descriptivo, por ejemplo "API Tienda propia" o "Sistema ERP".

Obtener credenciales

Despues de guardar recibes la URL del endpoint API y puedes generar un token JWT para la autenticacion.

El token JWT para la autenticacion API lo generas en tu Workspace en AutoLetter. Guarda este token de forma segura y no lo compartas con personas no autorizadas.

Los pedidos se envian como array JSON mediante una solicitud POST al endpoint API. La autenticacion se realiza mediante un Bearer JWT-Token en el encabezado Authorization.

curl -X POST https://api.autoletter.eu/v2/orders \
  -H "Authorization: Bearer TU_TOKEN_JWT" \
  -H "Content-Type: application/json" \
  -d '[
    {
      "OrderNumber": "ORD-2026-001",
      "OrderId": "12345",
      "Date": "2026-02-20T10:30:00Z",
      "Total": 89.99,
      "Address": {
        "FirstName": "Max",
        "LastName": "Mustermann",
        "Street": "Musterstraße",
        "HouseNumber": "42",
        "ZIP": "10115",
        "City": "Berlin",
        "Country": "DE"
      }
    }
  ]'

Cada pedido debe contener los siguientes campos:

Campo	Tipo	Descripcion
`OrderNumber`	String	El numero de pedido
`OrderId`	String	Un ID de pedido unico
`Date`	String (ISO 8601)	La fecha del pedido
`Total`	Number	El importe total del pedido
`Address`	Object

El objeto Address contiene la direccion de envio y debe incluir al menos nombre, calle, numero, codigo postal, ciudad y pais.

Ademas de los campos obligatorios, puedes transmitir los siguientes campos opcionales:

Campo	Tipo	Descripcion
`ExternalId`	String	ID de referencia externa de tu sistema
`ShopId`	String	Identificador de tienda en operacion multi-tienda
`InvoiceAddress`	Object	Direccion de facturacion diferente
`LetterAddress`	Object	Direccion diferente para el envio de cartas
`Products`

Por defecto solo se crean nuevos pedidos. Si quieres actualizar pedidos existentes, anade el parametro allowUpdates a tu solicitud:

{
  "allowUpdates": true,
  "orders": [...]
}

Con allowUpdates activado, los pedidos con OrderId coincidente se actualizan en lugar de ser rechazados.

A diferencia de Billbee y Shopify, con la integracion API no hay retraso de sincronizacion. Los pedidos que envias por API estan disponibles inmediatamente en AutoLetter y pueden usarse directamente en campanas.

La API devuelve codigos de estado HTTP estandarizados:

200 OK -- Pedidos procesados exitosamente
400 Bad Request -- Datos incorrectos (detalles en el cuerpo de la respuesta)
401 Unauthorized -- Token JWT invalido o faltante
429 Too Many Requests -- Limite de solicitudes alcanzado

En caso de errores, la respuesta contiene informacion detallada sobre los registros afectados.