Ventiapp
Buscar…
Primary version
Qué es Ventiapp?
Canales
Configuración
Marketplace
Desarrolladores
F.A.Q.
Consideraciones
API
Autenticación
Categorías
Facturas
Productos
Publicaciones
Mensajes
Stock y Precios
Uso de token
Ventas
Webhooks
Límite de Uso
Cambios y avances
Próximos cambios
Soporte Técnico
Accionado por GitBook
Ventas
En esta sección se encuentran todas las API's de Ventiapp relacionadas a Ventas
get
https://ventiapi.azurewebsites.net/api
/orders/orders
Get Orders
Las opciones válidas para el parámetro de sort son:
  • added_desc : Fecha de Alta en VentiApp descendiente
  • added_asc: Fecha de Alta en VentiApp ascendiente
  • created_desc: Fecha de creación inicial de la compra descendiente
  • created_asc: Fecha de creación inicial de la compra ascendiente
  • modified_desc: Fecha de modificación de la compra descendiente
  • modified_asc: Fecha de modificación de la compra ascendiente

Channels

Las opciones válidas para el parámetro channel son:
  • "amazon" (Amazon)
  • "claroshop" (Claroshop)
  • "elektra" (Elektra)
  • "linio" (Linio)
  • "liverpool" (Liverpool)
  • "meli" (Mercado Libre)
  • "mshops" (Mercado Shops)
  • "prestashop" (Prestashop)
  • "shopify" (Shopify)
  • "venticommerce" (VentiCommerce)
  • "vtex" (VTEX)
  • "walmart" (Walmart) //Plataforma antigua MIRAKL //DEPRECATED
  • "walmartEDI" (Walmart) // Plataforma nueva Walmart EDI
  • "wish" (Wish)
  • "woocommerce" (WooCommerce)
  • "walmartUS" (Walmart United States) //Version USA
  • "amazon_us" (Amazon United States) //Version USA
  • "tiendanube" (Tienda Nube)
    ​
get
https://ventiapi.azurewebsites.net/api
/orders/findorder
Find Order
​
post
https://ventiapi.azurewebsites.net/api
/orders/createorder
Create Order
Body de la llamada:
1
{
2
3
"channel": "your_channel",
4
"externalId": "111444123",
5
"total": 660.0,
6
"currency": "MXN",
7
"tax": 0.16,
8
"comments": "Send it before tuesday",
9
"title": "Order Title",
10
"cartId": "00000101110002",
11
"externalNumber": "12314512",
12
"items": [{
13
"itemExternalId": "MLM3312341",
14
"title": "Item 1",
15
"price": 460.0,
16
"itemQuantity": 1,
17
"total": 460.0,
18
"sku": "ITEM-RED001",
19
"erpId": "ITEM-123"
20
},
21
{
22
"itemExternalId": "MLM3317841",
23
"title": "Item 2",
24
"price": 200.0,
25
"itemQuantity": 1,
26
"total": 200.0,
27
"sku": "PLAINITEM001",
28
"erpId": "ITEM-456"
29
}
30
],
31
"buyer": {
32
"name": "John",
33
"lastname": "Doe",
34
"email": "[email protected]",
35
"state": "Distrito Federal",
36
"address": "Street Address 123",
37
"city": "Mexico City",
38
"zipcode": "06700",
39
"nickname": "JOHNDOEVENTI",
40
"phone": "5584848152",
41
"externalId": "551331413"
42
},
43
"shipping": {
44
"sellerInfo": "MYSELLERNAME",
45
"sellerId": "MYSELLERID",
46
"shipmentType": "Express",
47
"shippingStatus": "shipped",
48
"shippingCourier": "drop_off",
49
"shippingId": "27586098188",
50
"shippingTrackingId": "10003313132",
51
"shippingCourierExternal": "Fedex Express",
52
"shippingCost": 120.0
53
}
Copied!
​
put
https://ventiapi.azurewebsites.net/api
/orders/updateorder/
Update Order
Ejemplo de la llamada:
1
{
2
3
"channel": "your_channel",
4
"externalId": "111444123",
5
"total": 660.0,
6
"currency": "MXN",
7
"tax": 0.16,
8
"comments": "Send it before tuesday",
9
"title": "Order Title",
10
"cartId": "00000101110002",
11
"externalNumber": "12314512",
12
"items": [{
13
"itemExternalId": "MLM3312341",
14
"title": "Item 1",
15
"price": 460.0,
16
"itemQuantity": 1,
17
"total": 460.0,
18
"sku": "ITEM-RED001",
19
"erpId": "ITEM-123"
20
},
21
{
22
"itemExternalId": "MLM3317841",
23
"title": "Item 2",
24
"price": 200.0,
25
"itemQuantity": 1,
26
"total": 200.0,
27
"sku": "PLAINITEM001",
28
"erpId": "ITEM-456"
29
}
30
],
31
"buyer": {
32
"name": "John",
33
"lastname": "Doe",
34
"email": "[email protected]",
35
"state": "Distrito Federal",
36
"address": "Street Address 123",
37
"city": "Mexico City",
38
"zipcode": "06700",
39
"nickname": "JOHNDOEVENTI",
40
"phone": "5584848152",
41
"externalId": "551331413"
42
},
43
"shipping": {
44
"sellerInfo": "MYSELLERNAME",
45
"sellerId": "MYSELLERID",
46
"shipmentType": "Express",
47
"shippingStatus": "shipped",
48
"shippingCourier": "drop_off",
49
"shippingId": "27586098188",
50
"shippingTrackingId": "10003313132",
51
"shippingCourierExternal": "Fedex Express"
52
}
Copied!
​
​
post
https://ventiapi.azurewebsites.net/api
/orders/updateshippinglabel/?orderId=XXXX
Update Shipping Label
Body de la llamada:
1
{
2
"shippingTrackingId": "78713341882",
3
"shippingLabelUrl": "https://myserver.com/78713341882.pdf",
4
"shippingCourier": "DHL",
5
"shippingCourierCode": "XXX",
6
"shippingInvoiceNumber": "INV0001"
7
}
Copied!

Campos

shippingTrackingId: Tracking ID del envío shippingLabelUrl: URL para descargar el PDF, ZPL ó guía shippingCourier: Paquetería utilizada para el envío shippingCourierCode(opcional): Código opcional a requerir según el canal de la venta (solo aplica en Liverpool) shippingInvoiceNumber(opcional): ID de Factura para asociar la guía

Comportamiento por canal

MercadoLibre: shippingTrackingId, status(solo para el update si es creación se pone por defecto "shipped"). Wish:shippingTrackingId, shippingCourier. WalmartEDI: shippingTrackingId, shippingCourier, shippingLabelUrl. Vtex : shippingTrackingId,shippingCourier,shippingInvoiceNumber ,shippingLabelUrl. Elektra: shippingTrackingId, shippingCourier, shippingLabelUrl. Amazon: shippingTrackingId, shippingCourier. Shopify: shippingTrackingId, shippingCourier, shippingLabelUrl. Liverpool: shippingTrackingId, shippingCourier, shippingCourierCode, shippingLabelUrl. WooCommerce: N/A Claroshop: N/A Linio: N/A TiendaNube : N/A
post
https://ventiapi.azurewebsites.net/api
/orders/updateshippingstatus/?orderId=XXXX
Update Shipping Status
Body de la llamada:
1
{
2
"shippingStatus": "shipped"
3
}
Copied!
post
https://ventiapi.azurewebsites.net/api
/orders/adddigitalredeems
Add Digital Redeems
Body de la llamada:
1
{
2
"orderId": "4592185", //ID DE VENTA INTERNO DE VENTIAPP
3
"dateRedeem": "18/02/2021",
4
"redeems": [
5
{
6
"productName": "OFFICE",
7
"brand": "OFFICE",
8
"key": "KEY012345678", //OPCIONAL
9
"description": "MICROSOFT 365 EMPRESA BÁSICO"
10
},
11
{
12
"productName": "Avast Free Antivirus 2021",
13
"brand": "Avast",
14
"urlRedeem": "https://www.avast.com/redeem?id=123456", //OPCIONAL
15
"description": "Detecte virus, ransomware y otras amenazas en tiempo real."
16
}
17
],
18
"messages":[ //OPCIONAL
19
{
20
"text":"Hola {{NOMBRE}} {{APELLIDO}}, gracias por comprar en {{NOMBRE_TIENDA}}"
21
},
22
{
23
"text":"Para hacer Redeem de tu licencia de {{NOMBRE_PRODUCTO}} deberás ingresar aquí {{LINK_REDEEM}}"
24
},
25
{
26
"text":"Te recordamos que puedes verificar nuestros tutoriales en los adjuntos dentro del portal de redeem"
27
}
28
],
29
"attachments":[ //OPCIONAL
30
{
31
"url":"https://ventiapp.com/help/redeem.pdf",
32
"text":"Manual de redeem para producto digital"
33
},
34
{
35
"url":"https://ventiapp.com/help/redeem2.pdf",
36
"text":"Manual de redeem 2 para producto digital"
37
},
38
]
39
40
}
Copied!
Información sustituible: El nuevo campo de messages soporta información sustituible, la cual se generará a partir de la información de la orden. Los campos son los siguientes: {{NOMBRE}} -> Nombre del comprador {{APELLIDO}} -> Apellido del comprador {{NOMBRE_PRODUCTO}} -> Nombre del item que se compro en la orden {{NOMBRE_TIENDA}} -> Nombre de la tienda oficial, ó nombre del usuario del canal de venta {{LINK_REDEEM}} -> Aquí aparecerá el link hacia el portal de redeem de Ventiapp
put
https://ventiapi.azurewebsites.net/api/orders/
UpdateExternalErpId
Update external ID
​
Las opciones válidas para el parámetro canal son:
  • "meli" (Mercado Libre)
  • "amazon" (Amazon)
  • "amazon_us" (Amazon United States) // Version USA
  • "bestbuyca" (Best Buy CA) // Version Canada
  • "claroshop" (Claroshop)
  • "cyberpuerta" (Cyberpuerta)
  • "doto" (Doto)
  • "elektra" (Elektra)
  • "linio" (Linio)
  • "liverpool" (Liverpool)
  • "magento" (Magento)
  • "market" (Market)
  • "mshops" (Mercado Shops)
  • "prestashop" (Prestashop)
  • "shiphero" (ShipHero)
  • "shopify" (Shopify)
  • "tiendanube" (Tienda Nube)
  • "ventiapp" (Ventiapp)
  • "venticommerce" (VentiCommerce)
  • "vtex" (VTEX)
  • "walmart" (Walmart)
  • "walmartus" (Walmart United States) // Version USA
  • "walmartedi" (Walmart) // Plataforma Walmart EDI
  • "wish" (Wish)
  • "woocommerce" (WooCommerce)
post
https://ventiapi.azurewebsites.net/api/orders/
UpdateErpId
Update ERP ID

Notas importantes

Webhooks
En el apartado de Webhook se definen notas importantes de las cuales es recomendado que se tengan en cuenta, sobre todo con compras de Mercado Libre y Linio. Ver aquí​
Fechas
Todos los campos de fechas que se retornan por API están en Zona Horaria Universal (UTC), la cual deberás calcular si deseas tener en tiempo local de tu país.

Estados posibles de órdenes

A partir del 21/10/2020 las ordenes consultadas por API tendrán la siguiente unificación de los estados originales del canal a los siguientes.
Estado
Descripción
confirmed
Confirmada, sin pagar
pending
Orden pendiente, en estado de espera
paid
Pagada
cancelled
Cancelada
returned
Retornada
refused
Rechazada
partial_returned
Devolución Parcial

Estados posibles de logística

Existen varios tipos distintos de logística de acuerdo al tipo de órden que se generer desde la plataforma web ó marketplace. A continuación una lista de los estados más utilizados, es posible que existan adicionales en casos especiales. Este campo es shippingCourier
Estado
Descripción
drop_off
Estado de Dropshipping, cuando tu negocio está encargado del envío
xd_drop_off
Estado de Dropshipping, cuando tu negocio está encarado del envío pero este será auna agencia
fulfillment
Estado de envío de Fulfillment, estará encargado el marketplace
custom
Estado de envío customizado, generalmente es cuando el usuario define sus tipos de envío
not_specified
Estado de envío sin especificar, en este caso hay que ponerse de acuerdo con el comprador
post
https://ventiapi.azurewebsites.net/api/orders/
redact
Ofusca datos personales de los compradores
Body de la llamada:
1
{
2
"orders":["12345","12351","45412","434912315233","20000000142461235"]
3
}
Copied!
post
https://ventiapi.azurewebsites.net/api/orders/
CancelOrder
Cancela ó notifica requerimiento de Cancelación
Anterior
Uso de token
Próximo
Webhooks
Última actualización 16d ago
Copiar enlace
Contenidos
get
Get Orders
Channels
get
Find Order
post
Create Order
put
Update Order
get
Print Label
post
Update Shipping Label
post
Update Shipping Status
post
Add Digital Redeems
put
Update external ID
post
Update ERP ID
Notas importantes
Estados posibles de órdenes
Estados posibles de logística
post
Ofusca datos personales de los compradores
post
Cancela ó notifica requerimiento de Cancelación