Glosario
Vocabulario de la API de entregas
Cada término que usan la API, la consola y la app del conductor, en una frase, con un enlace a donde importa.
- AutoaceptaciónVer →
- Reglas que fija el conductor (distancia, tamaños, horario, zonas) para que las ofertas que coinciden se acepten en segundos.
- Clase de tamañoVer →
- S (sobre o bolsa), M (caja de zapatos a mochila), L (maleta) o XL (necesita furgoneta); escala el precio y filtra a qué conductores se ofrece.
- Clave sandboxVer →
- Una clave de prueba que puedes generar desde precios o la consola para probar todo el flujo sin gastar nada.
- Compensación por el regresoVer →
- La parte del precio de ciudad a ciudad que cubre el viaje de vuelta en vacío del conductor: la mitad de la distancia y del tiempo de conducción de ida.
- ConfirmarVer →
- Tu aceptación de la prueba, que captura los fondos; si no la llamas, la entrega se confirma sola 24 horas después.
- CotizaciónVer →
- Una oferta con precio y ruta para una entrega, devuelta por POST /v1/quotes con desglose y ETAs; gratis, sin clave, válida 15 minutos.
- De ciudad a ciudadVer →
- Entrega en el día desde una ciudad de lanzamiento a una ciudad de lanzamiento vecina a hasta 160 km por carretera, con un solo conductor dedicado.
- Enlace de seguimientoVer →
- Una página pública por entrega con estado en vivo, posición del conductor y ETA, personalizable con tu logo y colores.
- EntregaVer →
- Un trabajo reservado desde una recogida hasta una o más entregas, con línea de estados, prueba y enlace de seguimiento.
- Entrega con OTPVer →
- Un código de un solo uso que pones en los metadatos; el receptor se lo lee al conductor y el trabajo no puede cerrarse sin él.
- Entrega recurrenteVer →
- Una plantilla que se reserva sola en los días y horas elegidos; se gestiona en la consola y por el worker recurrente.
- Firma de webhookVer →
- Una cabecera HMAC en cada webhook para verificar que el evento viene de RentADriver; envíos de prueba desde la consola.
- HitoVer →
- Un paso registrado de una entrega, como la mercancía a bordo en la recogida, que cambia qué se puede cancelar.
- Hora límite del mismo díaVer →
- Una entrega de ciudad a ciudad debe llegar antes de las 21:00 hora local; si se reserva demasiado tarde para eso, se recoge a la mañana siguiente.
- Libreta de direccionesVer →
- Lugares de recogida y entrega guardados con contactos, usables desde la consola y la API.
- Modo de pruebaVer →
- Las claves de prueba crean entregas is_test con conductores simulados y sin movimiento de monedero; la consola las muestra bajo un aviso de sandbox.
- MonederoVer →
- El saldo prepagado del que se financia una entrega; recárgalo con tarjeta o USDC y revisa cada movimiento en la consola.
- OfertaVer →
- Un trabajo propuesto a un conductor en RentADriver Go con sus detalles; se acepta con un toque o automáticamente según sus reglas.
- Ola de despachoVer →
- Una ronda de ofertas enviada a conductores en turno cerca de la recogida; el radio crece ola a ola hasta que alguien acepta.
- ParadaVer →
- Una dirección de recogida o entrega con datos de contacto; una entrega local admite hasta 8 entregas, una de ciudad a ciudad hasta 3.
- Prueba de entregaVer →
- Fotos geolocalizadas, firma o código de un solo uso capturados en la entrega y devueltos por get_proof_of_delivery.
- quote_idVer →
- El identificador de una cotización; pásalo a create_delivery para reservar exactamente a ese precio.
- RecargoVer →
- Un multiplicador en vivo cuando la demanda supera la oferta cercana; siempre visible en el desglose.
- Retención y capturaVer →
- El precio completo se retiene en tu monedero al reservar y se captura al confirmar; una cancelación libera la retención.
- Servidor MCPVer →
- rentadriver-mcp, el servidor Model Context Protocol que expone cada capacidad de la API como herramientas para un agente.
- TurnstileVer →
- La verificación humana opcional en registros desde navegador; agentes, servidor MCP y curl están exentos.
- UrgenciaVer →
- asap, today o scheduled; define la ventana de despacho y uno de los multiplicadores del precio.
- Valor declaradoVer →
- value_cents que fijas en un artículo: queda registrado con la entrega para valorar una reclamación por pérdida o daño.
- Valoración del receptorVer →
- La nota de 1 a 5 que deja el receptor en la página de seguimiento tras la entrega; los conductores ven su promedio.
- Zona de servicioVer →
- Una ciudad de lanzamiento con centro, radio y tarifa propia; check_coverage rechaza cotizaciones fuera de toda zona.