Ventas

🔹 Crear una venta

Consulta: POST /v1/{marketplace_code}/orders

Crea una nueva venta para una conexión específica.

Campos:

Nombre	Descripción	Tipo de dato	Obligatorio
marketplace_connection	ID de la conexión marketplace del vendedor	Integer	X
creation_date	Fecha de creación	Date	X
reference_order	Referencia de la orden en el sistema externo	String	X
status	Estado inicial de la venta	String	X
products_subtotal	Subtotal de productos (sin envío)	Number	X
shipping_subtotal	Subtotal de envío	Number	X
billing_address	Datos de facturación	Object	X
shipping_address	Datos de envío	Object	X
payments	Pagos asociados a la venta	Array<Object>	X
shipping_info	Información de envíos y tracking	Array<Object>	X
products	Productos incluidos en la venta	Array<Object>	X
discounts	Descuentos aplicados	Array<Object>

Aclaraciones:

• El campo marketplace_connection es el ID de cada conexión. Se puede usar el índice de conexiones para obtenerlo.

Ejemplo de payload:

  {
    "marketplace_connection": 1450,
    "creation_date": "2024-01-24T13:24:09+00:00",
    "reference_order": "test-order",
    "status": "APRO",
    "products_subtotal": 22499,
    "shipping_subtotal": 0,
    "billing_address": {
      "name": "John",
      "surname": "Doe",
      "email": "johndoe@example.com",
      "province": "CIUDAD AUTÓNOMA DE BUENOS AIRES",
      "city": "Ciudad Autónoma de Buenos Aires",
      "address": "Av. Medrano",
      "number": "2966",
      "floor": "1ero",
      "door": "C",
      "extra_information": "Edificio de color naranja.",
      "phone": "+5491155886697",
      "zip_code": "1430",
      "document": {
        "type": "DNI",
        "number": "35875257"
      }
    },
    "shipping_address": {
      "name": "John",
      "surname": "Doe",
      "email": "johndoe@example.com",
      "province": "CIUDAD AUTÓNOMA DE BUENOS AIRES",
      "city": "Ciudad Autónoma de Buenos Aires",
      "address": "Av. Medrano",
      "number": "2966",
      "floor": "1ero",
      "door": "C",
      "extra_information": "Edificio de color naranja.",
      "phone": "+5491155886697",
      "zip_code": "1430",
      "document": {
        "type": "DNI",
        "number": "35875257"
      }
    },
    "payments": [
      {
        "gateway": "Decidir",
        "payment_amount": 22499,
        "payment_date": "2024-01-24T13:24:09+00:00",
        "nominal_interest": 0,
        "payment_method": {
          "document": {},
          "card": {
            "brand": "VISA Santander",
            "card_number": "XXXX XXXX XXXX 5788",
            "date_card_expiration": "",
            "installments": 0,
            "first_digits": null,
            "last_digits": "5788",
            "interest": 0
          },
          "connector": {
            "connector_tid": null,
            "connector_authid": null,
            "use_government_plan": "No informa"
          }
        },
        "type": "CARD",
        "transaction_id": null
      }
    ],
    "shipping_info": [
      {
        "products": [
          {
            "sku": "PIN-PAW5646"
          }
        ],
        "tracking_number": "",
        "carrier": {
          "code": "1",
          "name": "Transportadora estándar"
        },
        "pickup_address_id": null
      }
    ],
    "products": [
      {
        "name": "SABANA PAW PATROL 90x190",
        "quantity": 1,
        "sku": "PIN-PAW5646",
        "unit_price": 22999,
        "taxes": 21
      }
    ],
    "discounts": [
      {
        "reference": "Discounts",
        "name": "Reintegro por oferta",
        "amount": 500,
        "amount_with_taxes": 500
      }
    ]
  }

Ejemplo de consulta:

curl --location 'https://marketplace.api.fulljaus.com/v1/acme/orders' --header 'Content-Type: application/json' --header 'Authorization: Bearer asdf1234' --data @payload.json

Respuesta:

Código HTTP: 201 Devuelve la venta creada con su id.

---

🔹 Actualizar una venta

Consulta: POST /v1/{marketplace_code}/orders/{reference}?marketplace_connection={id}

Cambia el estado de una venta según las transiciones permitidas.

Campos:

Nombre	Descripción	Tipo de dato	Obligatorio
status	Estado al que se desea cambiar	String	X

Aclaraciones:

• Debe respetar el orden de transiciones permitidas (ver tabla “Estados de ventas y transiciones”).
• El parámetro marketplace_connection es el ID de cada conexión. Se puede usar el índice de conexiones para obtenerlo. El parámetro es obligatorio.

Ejemplo de payload:

{
  "status": "PROC"
}

Ejemplo de consulta:

curl --location 'https://marketplace.api.fulljaus.com/v1/acme/orders/65b159bcac3c2b9775730580/status' --header 'Content-Type: application/json' --header 'Authorization: Bearer asdf1234' --data '{"status": "PROC"}'

Respuesta exitosa:

{
  "success": true
}

---

🔹 Obtener una venta por Código de Referencia

Consulta: GET /v1/{marketplace_code}/orders/{reference_order}

Retorna el contenido de una venta específica.

Ejemplo de consulta:

curl --location 'https://marketplace.api.fulljaus.com/v1/acme/orders/65b159bcac3c2b9775730580' --header 'Authorization: Bearer asdf1234'

Respuesta: Código HTTP: 200 Devuelve un objeto con el detalle de la venta.

---

🔹 Obtener listado de ventas

Consulta: GET /v1/{marketplace_code}/orders

Retorna todas las ventas del canal.

Filtros disponibles:

Query param	Tipo de dato	Descripción
seller_id	String	Retorna las ventas de un vendedor específico.
status	String	Retorna las ventas que estén en el estado indicado.
reference	String	Retorna las ventas que tengan el código de referencia.
has_invoice	Boolean	Retorna las ventas con factura cargada si es true.

Ejemplo de consulta:

curl --location 'https://marketplace.api.fulljaus.com/v1/acme/orders?seller_id=1&status=APRO' --header 'Authorization: Bearer asdf1234'

Respuesta: Código HTTP: 200 Devuelve un Array<Object> con las ventas que cumplen los filtros.