Opciones y proveedores

Qué es una opción, por qué un proveedor puede ofrecer varias, cómo se ordenan, qué significan la calidad y el stock, y cómo se fijan los precios.

Insertar
Vista previa de la tarjeta
<a href="https://numestri.com/docs/es/options-and-providers"><img src="https://numestri.com/docs/_api/public/orgs/25229885-9620-4c08-bd2e-a0d0d74ac8b6/spaces/ef21e0c3-966d-4b03-b6d2-e66d449835d4/pages/089e5cd3-dc59-4acb-a90b-2c3766702ab3/social-card.svg?v=3e7ae33eec8b" alt="Opciones y proveedores" width="600" height="315"></a>

Una opción es una forma concreta de completar un pedido: un proveedor que vende una plataforma en un país, desde uno de sus propios grupos de números, a un precio. Un proveedor es el proveedor anónimo que hay detrás de un conjunto de opciones.

Por qué un proveedor puede tener varias opciones

Los proveedores suelen vender la misma plataforma desde varios grupos de números, con precios distintos y stock distinto. Cada grupo que tiene números es su propia opción, así que puedes elegir entre ellas en lugar de recibir la que sea más barata.

Cómo se ordenan las opciones

Dentro de una plataforma y un país, las opciones se muestran de mejor a peor:

  1. Con stock antes que agotadas.

  2. Probadas antes que los proveedores que se reservan por tener un mal historial de entrega en esta plataforma y este país concretos.

  3. Historial de entrega en esta combinación, aprendido de pedidos reales, de modo que un proveedor excelente para Telegram en el Reino Unido puede quedar el último para WhatsApp en Estados Unidos.

  4. Precio, para desempatar.

Un pedido que no indica ninguna opción las prueba en este orden y pasa a la siguiente si una no puede entregar.

Campos

Aparecen en cada opción, en el árbol del catálogo y en /request/price. Los proveedores llevan los mismos quality y success_rate, porque el historial de un proveedor es por plataforma y país.

Campo

Significado

option

El id que debes enviar como option para comprar exactamente esta. Es opaco: cópialo, no lo construyas.

provider

El identificador anónimo del proveedor (prv_…), el mismo en todas las plataformas y países. Envíalo como provider para pedir solo a ese proveedor. (En el árbol va en la ruta, no en cada opción).

rank

Posición dentro de la plataforma y el país; 1 es la primera.

price / price_cents

Lo que pagas, por número.

quality

excellent, good, fair o poor, o null hasta que haya suficientes pedidos reales que respalden una valoración. Preferimos no mostrar nada antes que una suposición.

success_rate

La proporción de pedidos que recibieron un código, redondeada al 5 %, cuando hay datos suficientes; si no, null.

stock

plenty, limited, none o unknown. Las cantidades exactas no se muestran.

in_stock

Solo en /request/price: si la opción se puede comprar en este momento.

Cómo se fijan los precios

Todos los precios los fijamos nosotros, y tú nunca envías uno: el importe que se te cobra se calcula de nuestro lado en el momento del pedido.

  • Precios públicos. Sin una clave de API, el catálogo y las cotizaciones muestran el precio de lista público.

  • Tus precios. Con tu clave, muestran los precios de tu cuenta. Son los mismos que la lista pública, salvo que tu cuenta tenga precios negociados; en ese caso pueden ser distintos.

  • Lo que ves es lo que pagas. A un pedido se le cobra el precio que se le mostró a tu cuenta: un option exacto, a su precio de lista; un provider, a su opción más barata con stock; y si no, al precio de la mejor opción (el price de /request/price). Si el mercado se movió entre que miraste y que pediste, el pedido se cobra al precio actual: envía max_price y todo lo que supere tu tope se rechaza con PRICE_ABOVE_MAX antes de cobrarte.

Elegir bien

Lo más barato suele bastar. Si una combinación es importante (por ejemplo, una plataforma que rechaza muchos números), prefiere una opción con una quality probada o fija un provider que te haya funcionado antes.

Actualizado