Vignetim

Detalle de pedido

Obtenga los detalles completos de un pedido (order) específico o consulte su estado actual.

Obtener detalles del pedido

GET /orders/:id

Parámetros de ruta

NombreTipoRequeridoDescripción
idstringEl ID del pedido (p. ej., ord-a1b2c3d4-e5f6-7890-abcd-ef1234567890)

Respuesta

{
	"id": "ord-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
	"status": "COMPLETED",
	"products": [
		{
			"productId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
			"productTypeId": 1,
			"productName": "Austria 10-Day Vignette",
			"quantity": 1,
			"status": "COMPLETED",
			"vehiclePlate": "AB123CD",
			"vehicleCountryIsocode": "AT",
			"startAt": "2026-04-01T00:00:00.000Z",
			"endAt": "2026-04-10T23:59:59.000Z"
		}
	],
	"payment": {
		"type": "CARD",
		"status": "CAPTURED",
		"paidAt": "2026-03-20T14:31:10.000Z"
	},
	"customer": {
		"email": "john.doe@example.com",
		"firstName": "John",
		"lastName": "Doe"
	},
	"total": {
		"amount": 11.5,
		"currency": "EUR"
	},
	"externalReference": "YOUR-ORDER-REF-001",
	"idempotencyKey": "unique-order-key-12345",
	"createdAt": "2026-03-20T14:30:00.000Z",
	"completedAt": "2026-03-20T14:31:15.000Z"
}

Obtener estado del pedido

Un endpoint ligero que devuelve únicamente el estado actual del pedido, útil para consultas periódicas (polling).

GET /orders/:id/status

Parámetros de ruta

NombreTipoRequeridoDescripción
idstringEl ID del pedido

Respuesta

{
	"id": "ord-a1b2c3d4-e5f6-7890-abcd-ef1234567890",
	"status": "COMPLETED",
	"updatedAt": "2026-03-20T14:31:15.000Z"
}

Estados de pedido

EstadoDescripción
PENDINGPedido creado, esperando confirmación de pago
PROCESSINGPago confirmado, productos en proceso de aprovisionamiento
COMPLETEDTodos los productos entregados exitosamente
FAILEDFallo en el pago o error en el aprovisionamiento del producto
CANCELLEDEl pedido fue cancelado
REFUNDEDEl pedido fue reembolsado