Carrito abandonado

Un carrito abandonado representa una orden iniciada por un cliente que no fue finalizada. Permite hacer seguimiento, recuperación y acciones de remarketing.

---

Propiedades

Propiedad	Descripción
id	Identificador único del carrito
number	Número del carrito
payment_title	Título del pago
payment_status	Estado del pago
total	Total del carrito
subtotal	Subtotal del carrito
created_at	Fecha de creación
updated_at	Fecha de última actualización
note	Notas del carrito abandonado
currency	Tipo de moneda de la tienda
tracking_link	Link de recuperación del carrito
customer	Información básica del cliente
products	Lista de productos en el carrito

---

Endpoints

GET /abandoned-cart

Obtiene una lista de carritos abandonados.

Parámetros de query

Parámetro	Descripción
q	Filtrar por ID o número de orden
page	Número de página
per_page	Cantidad de resultados por página
customer_email	Filtrar por email del cliente
updated_at_from	Fecha mínima de actualización (ISO UTC)
updated_at_to	Fecha máxima de actualización (ISO UTC)

Ejemplo de respuesta

HTTP/1.1 200 OK

{
  "pagination": {
    "total": 120,
    "page": 1,
    "per_page": 50,
    "next_page": "https://developers.tiendanegocio.com/v1/abandoned-cart?page=2&per_page=50"
  },
  "results": [
    {
      "id": 1,
      "number": 1234,
      "payment_status": "abandoned",
      "payment_title": "Tarjeta de débito o crédito",
      "total": "50",
      "subtotal": "50",
      "note": "Esperando que pague",
      "currency": "ARS",
      "tracking_link": "https://example.tiendanegocio.com/compra/proceso/orden?hash=XXX",
      "created_at": "2026-04-07T15:02:37.000Z",
      "updated_at": "2026-04-07T15:02:37.000Z",
      "customer": {
        "id": 92,
        "name": "Juan Pérez",
        "email": "juan@email.com"
      },
      "products": [
        {
          "id": 1,
          "product_id": 11,
          "variant_id": 17,
          "name": "Remera",
          "quantity": 1,
          "image": "https://cdn...image.webp",
          "price": "25",
          "sku": "SKU-1"
        }
      ]
    }
  ]
}

---

GET /abandoned-cart/{id}

Obtiene un carrito abandonado por ID.

Ejemplo

GET /abandoned-cart/1

HTTP/1.1 200 OK

{
  "id": 1,
  "number": 1234,
  "payment_status": "abandoned",
  "payment_title": "Tarjeta de débito o crédito",
  "total": "50",
  "subtotal": "50",
  "note": "Esperando que pague",
  "currency": "ARS",
  "tracking_link": "https://example.tiendanegocio.com/compra/proceso/orden?hash=XXX",
  "created_at": "2026-04-07T15:02:37.000Z",
  "updated_at": "2026-04-07T15:02:37.000Z",
  "customer": {
    "id": 92,
    "name": "Juan Pérez",
    "email": "juan@email.com"
  },
  "products": [
    {
      "id": 1,
      "product_id": 11,
      "variant_id": 17,
      "name": "Remera",
      "quantity": 1,
      "image": "https://cdn...image.webp",
      "price": "25",
      "sku": "SKU-1"
    }
  ]
}

---

POST /abandoned-cart

Crea un nuevo carrito abandonado.

Products

Parámetro	Descripción
product_id	ID del producto
variant_id	ID de la variante (opcional)
quantity	Cantidad

Shipment (opcional)

Parámetro	Descripción
name	Nombre del receptor
last_name	Apellido del receptor
email	Email del receptor
phone	Teléfono del receptor
shipment_title	Título del envío
zip_code	Código postal
province	Provincia
city	Ciudad
department	Departamento
direction	Dirección
street	Calle
street_number	Número
description	Descripción

Bill

Parámetro	Descripción
dni	DNI
name	Nombre
last_name	Apellido
email	Email
phone	Teléfono
direction	Dirección
street	Calle
street_number	Número
city	Ciudad
department	Departamento
zip_code	Código postal
province	Provincia

Ejemplo de request

{
  "note": "Carrito abandonado desde checkout",
  "payment_title": "Mercado Pago",
  "products": [
    {
      "product_id": 11,
      "variant_id": 17,
      "quantity": 2
    }
  ],
  "shipment": {
    "name": "Carlos",
    "last_name": "Martinez",
    "email": "carlos@email.com",
    "phone": "541112345678",
    "shipment_title": "Envío por moto",
    "zip_code": "1832",
    "province": "Buenos Aires",
    "city": "Lomas de Zamora",
    "department": "A",
    "direction": "Casa",
    "street": "Alsina",
    "street_number": "123",
    "description": "Dejar en portería"
  },
  "bill": {
    "dni": "string",
    "name": "Juan",
    "last_name": "Pérez",
    "email": "juan@email.com",
    "phone": "541112345678",
    "direction": "string",
    "street": "string",
    "street_number": "string",
    "city": "string",
    "department": "string",
    "zip_code": "string",
    "province": "string"
  }
}

Respuesta

HTTP/1.1 201 OK

{
  "id": 1,
  "number": 1234,
  "payment_status": "abandoned",
  "payment_title": "Mercado Pago",
  "total": "50",
  "subtotal": "50",
  "created_at": "2026-04-08T15:14:24.000Z",
  "updated_at": "2026-04-08T15:14:24.000Z",
  "note": "string",
  "currency": "ARS",
  "tracking_link": "https://example.tiendanegocio.com/compra/proceso/orden?hash=XXX",
  "customer": {
    "id": 1,
    "name": "Juan Pérez",
    "email": "juan@email.com"
  },
  "products": [
    {
      "id": 1,
      "product_id": 11,
      "variant_id": 17,
      "name": "remera",
      "quantity": 2,
      "image": "https://cdn.v2.tiendanegocio.com/example",
      "price": "50",
      "sku": "SKU-1"
    }
  ]
}

---

PUT /abandoned-cart/{id}

Actualiza un carrito abandonado existente.

Ejemplo

PUT /abandoned-cart/1

{
  "note": "Cliente contactado",
  "payment_status": "paid",
  "payment_title": "Pago en efectivo",
  "shipment_title": "Envío a domicilio"
}

Respuesta

HTTP/1.1 200 OK

{
  "id": 1,
  "number": 1234,
  "payment_status": "paid",
  "payment_title": "Pago en efectivo",
  "total": "50",
  "subtotal": "50",
  "created_at": "2026-03-27T15:00:00.000Z",
  "updated_at": "2026-03-27T16:00:00.000Z",
  "note": "Cliente contactado",
  "currency": "ARS",
  "tracking_link": "https://example.tiendanegocio.com/compra/proceso/orden?hash=XXX",
  "customer": {
    "id": 1,
    "name": "Juan Pérez",
    "email": "juan@email.com"
  },
  "products": [
    {
      "id": 1,
      "product_id": 11,
      "variant_id": 17,
      "name": "Remera",
      "quantity": 2,
      "image": "https://cdn.v2.tiendanegocio.com/null",
      "price": "25",
      "sku": "SKU-1"
    }
  ]
}