API para socios de Pochtoy.com: automatización de la entrega desde EE. UU.

La API de Pochtoy.com permite lanzar una tienda o un bot de Telegram con envío desde EE. UU. sin procesamiento manual de pedidos. White-label, cálculo de tarifas en tiempo real y seguimiento automático: la integración la realiza el desarrollador del socio, y el envío sale desde el almacén de Delaware hacia Rusia, Bielorrusia y Kazajistán.

02.05.2026

5263 views

API para socios de Pochtoy.com: automatización de la entrega desde EE. UU.

Tienda o bot de Telegram sin almacén en EE. UU.

La venta minorista de productos de Estados Unidos (zapatillas Nike, vitaminas de iHerb, ropa Levi's, gadgets Apple) se realiza sin necesidad de contar con almacenes propios en EE. UU. El papel del almacén lo asume un intermediario: recibe las compras, las empaqueta y las envía a los compradores. El canal de ventas puede ser cualquiera, desde una tienda online clásica hasta un bot de Telegram.

El procesamiento manual de un pedido se reduce siempre al mismo conjunto de acciones: entrar en el panel del intermediario, introducir los datos del comprador, esperar el número de seguimiento y reenviárselo al cliente. Con 20 pedidos al día, esta rutina se lleva de tres a cuatro horas. Un bot con cientos de pedidos al mes sin automatización deja de ser operativo.

La API de Pochtoy.com elimina esta carga. El socio se concentra en el marketing y en el servicio a los compradores, mientras que Pochtoy.com se encarga de toda la logística. La opción white-label hace que el trabajo del almacén sea invisible para los compradores finales.

Procesamiento manual frente a API: cuál es la diferencia

Etapa del trabajo Modo manual Automatización mediante API
Creación del pedido El operador copia los datos del cliente en el panel del intermediario La plataforma del socio envía el pedido de forma programática al instante
Declaración aduanera El contenido del paquete se introduce a mano en cada envío El contenido del pedido pasa a la declaración automáticamente
Control del procesamiento El gestor abre el panel periódicamente y comprueba los estados El sistema del socio recibe las actualizaciones en segundo plano sin intervención humana
Envío del seguimiento El número de seguimiento se copia en la conversación con el comprador El bot o el sitio web muestran el seguimiento al cliente en cuanto aparece
Costo de envío El comprador ve el precio solo después de realizar el pedido La tarifa se calcula por API y se muestra en el carrito
Crecimiento del volumen La cantidad de pedidos está limitada por las capacidades de los empleados Los pedidos llegan al almacén sin introducción manual, sea cual sea su cantidad

Ruta del pedido: del clic al paquete

Con la API conectada, cada pedido pasa por seis pasos sin intervención del operador.

1

El comprador forma el carrito

El cliente elige los productos en la tienda o el bot del socio e indica la dirección de entrega. Ve el precio final con el envío incluido antes de realizar el pedido.

2

La plataforma transmite el pedido por API

En una sola solicitud se envían los parámetros del paquete, los contactos del destinatario y los datos aduaneros. Sin introducción manual.

3

Recepción y procesamiento en el almacén estadounidense

Si es necesario, los compradores (buyers) de Pochtoy.com adquieren los artículos en tiendas de EE. UU. El paquete se prepara para el envío.

4

Los estados llegan al sistema del socio

Las etapas del procesamiento (recibido, empaquetado, entregado al transportista) llegan a la plataforma automáticamente por API.

5

Envío desde Delaware con número de seguimiento

El seguimiento se devuelve por API, tras lo cual el bot o el sitio web notifican automáticamente al comprador.

6

El cliente recibe el paquete en 5–15 días

Entrega a Rusia, Bielorrusia y Kazajistán. White-label: dentro del paquete no hay ni una palabra sobre Pochtoy.com.

Qué se intercambia entre el socio y Pochtoy.com

La transmisión de datos es bidireccional. La API REST es compatible con cualquier stack: Python, Node.js, PHP, Ruby.

El socio envía a Pochtoy.com
Nombres de los productos, cantidad, precios
Datos de contacto del destinatario: nombre, dirección, teléfono
Descripción del contenido del paquete para la declaración
Parámetros de la solicitud de tarifa: peso y país de destino
Pochtoy.com devuelve al socio
Confirmación de recepción e ID interno del pedido
Estado actual del procesamiento en cada etapa
Número de seguimiento tras la salida del almacén
Costo exacto del envío en tiempo real

La documentación se abre en el panel personal una vez aprobada la solicitud. Puede enviar la solicitud en la página API para socios.

Ventajas de conectarse a la API

🏷

Totalmente con la marca del socio

Dentro del paquete no hay nada que mencione a Pochtoy.com. Desde el primer contacto hasta la recepción, el comprador ve únicamente la marca de la tienda.

🛒

Los buyers comprarán el producto por usted

Si una tienda de EE. UU. exige una tarjeta estadounidense o PayPal, los empleados de Pochtoy.com comprarán el producto por el socio: con el código promocional GETITNOW es gratis; sin él, la comisión es del 7%, mínimo $7, y en tiendas complicadas (Apple, Sephora, Ralph Lauren, B&H y otras), del 15%, mínimo $15.

📦

Almacén en Delaware: sales tax 0%

Un estado sin impuesto sobre las ventas. Los paquetes entrantes se almacenan gratis durante 70 días. Con la tarifa Express uniremos varios paquetes en uno gratis.

💰

Bonificación por volumen

Las condiciones vigentes de la bonificación para socios están en la página API para socios.

🔒

Cumplimiento de la Ley Federal n.º 152

Los servidores con los datos personales de los compradores están ubicados en Rusia, lo que cumple los requisitos de la legislación rusa sobre datos personales.

💳

Opciones de pago flexibles

Se admiten tarjetas bancarias rusas y extranjeras. Es posible el pago automático de pedidos mediante API.

Tarifas para socios

Tres tarifas a Rusia, que se diferencian por el precio y las reglas (precios para Moscú). Todas están disponibles por API: la plataforma del socio muestra al comprador el costo actual incluso antes de realizar el pedido.

Tipo de envío Plazo Precio Qué se suele enviar
SuperFast 5–15 días desde $5.99 (desde 100 g) Compras propias del cliente, punto de recogida de CDEK
FastBox 5–15 días $27.99 hasta 1 kg Un paquete entrante, un paquete saliente, posible con compra por encargo
Express 5–15 días $36.99 hasta 1 kg Paquetes consolidados, mensajero o punto de recogida
Sin pagos ocultos: la consolidación de paquetes con la tarifa Express es gratuita, y los paquetes entrantes se almacenan gratis durante 70 días. El seguro contra pérdida en estas tarifas es obligatorio y de pago: desde $3 para productos de hasta $100.

Nichos prometedores para la reventa a través de Pochtoy.com

Categorías de productos en las que el envío desde EE. UU. tiene una demanda especialmente alta. Los socios eligen estas categorías con más frecuencia que las demás: paquetes de poco peso, una diferencia de precio notable con el comercio minorista ruso y una demanda estable.

Vitaminas y suplementos de iHerb

Demanda estable y paquetes ligeros. El arancel del 35% sobre los suplementos afecta a los lotes comerciales, no a los paquetes personales de los compradores.

iherb.com, vitacost.com, swansonvitamins.com

Zapatillas y calzado de EE. UU.

En los sitios de Nike, Adidas, New Balance, ASICS y Vans el precio es notablemente más bajo que en el comercio minorista ruso.

nike.com, adidas.com, newbalance.com, zappos.com, 6pm.com

Ropa de marcas estadounidenses

Ralph Lauren, Tommy Hilfiger, Calvin Klein y Levi's cerraron sus representaciones en Rusia. Pedir originales a través de un intermediario sigue teniendo demanda. Enviamos ropa y calzado con un valor de hasta $300 por unidad.

macys.com, ralphlauren.com, tommy.com, levi.com

Electrónica y gadgets

Accesorios de Apple, periféricos para gamers. Enviamos equipos con un valor de hasta $2500 por unidad y no más de dos dispositivos con baterías por paquete; no enviamos baterías sueltas.

amazon.com, bestbuy.com, apple.com, bhphotovideo.com

Nutrición deportiva

Las proteínas, los BCAA y los complejos preentreno estadounidenses son notablemente más baratos que sus análogos rusos.

iherb.com, bodybuilding.com, amazon.com

Cosmética y cuidado personal

Sephora, Ulta, Paula's Choice: marcas que no están disponibles en Rusia o cuestan bastante más. Enviamos cosméticos de a una unidad y solo junto con otros productos, hasta $300 por unidad.

sephora.com, ulta.com, paulaschoice.com, iherb.com
Aduana: el límite libre de aranceles es de 200 euros por paquete. Si se supera: arancel del 15% sobre el importe excedente, tasa de 700 rublos y comisión del agente aduanal del 5%. Más información: pochtoy.com/ru/faq/tolls

Cuatro pasos hasta el primer pedido

1

Creación de la cuenta y envío de la solicitud

En pochtoy.com se crea una cuenta de socio. En la página API para socios se envía una solicitud con la descripción de la plataforma (sitio web, bot de Telegram u otro canal) y el número de pedidos esperado al mes.

2

Acceso a la documentación de la API

Tras la aprobación, en el panel aparece una sección con materiales de integración: documentación técnica, claves de acceso y entorno de pruebas. Se describen los métodos para enviar pedidos, consultar estados, obtener el seguimiento y calcular tarifas.

3

Integración de la API en la plataforma

La API REST es compatible con Python, Node.js, PHP y Ruby. Un bot en Python con aiogram o telebot se conecta igual que cualquier otro servicio de terceros. Consulta de tarifa, envío del pedido y consulta de estados: tres bloques de código por parte del socio.

4

Pruebas y lanzamiento

Antes del lanzamiento se ejecutan 2-3 pedidos de prueba en el sandbox. Se comprueba: la corrección de los estados, la visualización del seguimiento, el funcionamiento del white-label y la entrega de notificaciones al cliente en nombre de la marca del socio. Una vez superadas las pruebas, se cambia a la clave de producción.

Cómo funciona el proceso por dentro: el recorrido del comprador

Cuando el comprador completa el pago, la plataforma transmite los datos a Pochtoy.com sin intervención de un operador. El cliente ve el progreso del pedido sin necesidad de contactar con la tienda.

Etapa Qué ve el comprador Qué ocurre en el sistema
En el carrito El precio del envío es visible antes de finalizar el pedido La plataforma solicitó la tarifa a través de la API y recibió la respuesta
Confirmación Mensaje de que el pedido fue recibido La plataforma envió el pedido a la API de Pochtoy.com
Almacén Notificación de procesamiento La API devuelve las etapas del movimiento del pedido en el almacén
Envío desde EE. UU. Mensaje con el número de seguimiento y un enlace de rastreo La API transmitió el seguimiento, el bot notificó al comprador automáticamente
Recibido Notificación final de recepción La API transmitió el último estado, el aviso se envió sin intervención del socio

Preguntas frecuentes sobre la API de Pochtoy.com

¿Qué tareas cubre la API y qué queda del lado del almacén?
La API se encarga de transmitir los pedidos, enviar los datos aduaneros, consultar los estados y obtener los números de seguimiento. La compra de productos en tiendas estadounidenses es un servicio aparte de los compradores de Pochtoy.com, que se activa una vez que el pedido llega al almacén.
¿Se puede prescindir de un desarrollador?
No. Para la conexión se requiere una API REST, lo que implica trabajar con el backend. La integración la realiza un desarrollador con experiencia en Python, Node.js o PHP. Si la tienda o el bot ya están en funcionamiento, añadir las llamadas a la API no se diferencia de conectar otros servicios de terceros.
¿Los compradores sabrán de Pochtoy.com?
En modo white-label, Pochtoy.com no aparece ni en el paquete, ni en la comunicación con el comprador, ni en el seguimiento. Toda la interacción se hace en nombre del socio. La relación de Pochtoy.com con el socio solo se nota en las operaciones de pago entre la empresa y el servicio; el comprador no lo ve.
¿Se puede mostrar el costo del envío antes de finalizar el pedido?
Sí. Uno de los métodos de la API devuelve la tarifa vigente en tiempo real. Según el peso del paquete y el país de destino, el sistema entrega el importe exacto, que se puede mostrar al comprador en el carrito o en la etapa de confirmación.
¿Cuál es el límite libre de aranceles al importar a Rusia?
La importación libre de aranceles está limitada a 200 euros por envío. Si se supera: arancel del 15% sobre el importe excedente, tasa de 700 rublos y comisión del agente aduanal del 5%. La aduana puede considerar los paquetes de un mismo lote como uno solo. Envío con la tarifa SuperFast: desde $5.99 (desde 100 g).
¿Cuándo recibirá el comprador el número de seguimiento?
El seguimiento se devuelve a través de la API en el momento en que el paquete sale del almacén en Delaware. La plataforma del socio lo recibe y notifica automáticamente al cliente. El plazo de entrega a Rusia es de 5–15 días, a Moscú y San Petersburgo, 6–7.
¿A qué países funciona el envío a través de la API?
Los destinos principales son Rusia, Bielorrusia y Kazajistán. Una sola API atiende a todos los países: el país del destinatario se indica como parámetro en los datos del pedido, y no se requiere una integración adicional para cada país.

Deje el envío desde EE. UU. en manos de Pochtoy.com

Envíe su solicitud: tras la aprobación, se abrirá la documentación de la API en el panel.

Obtener acceso a la API