Registrar el coste de una entrega
Solo desde el servidor del comercio, con clave secreta y permisos retention:view, retention:edit y settings:manage. Importa una línea de factura del proveedor para una entrega externa que ya se haya intentado. Identifica la entrega por deliveryId o providerMessageId; si envías ambos deben coincidir. amountMinor es una cadena entera en unidades mínimas de la moneda. Un coste cero requiere justificante explícito. La misma referencia e importe se pueden reenviar sin duplicar el coste; cambiar un coste ya registrado o reutilizar la referencia genera COST_RECEIPT_CONFLICT (400). La fuente queda identificada como MERCHANT_PROVIDER_RECEIPT: Bitelio no consulta ni verifica automáticamente la factura del proveedor. Una confirmación de entrega no acredita el coste. No se convierten monedas. Los costes que faltan permanecen pendientes y el informe se actualiza en segundo plano. Límite compartido de 120 solicitudes por minuto y proyecto. El parámetro id identifica la entrega; no es necesario repetirlo en el cuerpo.
Authorization
ApiKeyAuth Autenticación mediante clave de API. Las claves secretas (sk_*) son obligatorias en todos los endpoints excepto /v1/track. Las claves públicas (pk_*) solo funcionan con el endpoint /v1/track para el seguimiento de eventos desde el cliente. El proyecto se deriva automáticamente de la clave.
In: header
Path Parameters
length <= 100Request Body
application/json
1 <= length <= 200^[A-Z]{3}$^(0|[1-9]\d{0,13})$1 <= length <= 500Response Body
application/json
curl -X POST "https://bitelio-api.heltia.com/v1/retention/messages/string/cost-receipt" \ -H "Content-Type: application/json" \ -d '{ "receiptId": "invoice-2026-10:line-14", "currency": "EUR", "amountMinor": "7" }'{
"deliveryId": "string",
"recorded": true
}