Ir al contenido

Comando 103 — Servir pedidosrehacer

Servir un pedido desde la central de compras a la clínica es POST /order/{orderGID}/num/{orderGPartNum}/send. La llamada sirve lo que la central tenga en stock y mueve lo que aún no se pueda servir a una parte nueva del pedido. El modo manual de la V1 — servir exactamente las unidades indicadas por línea, o fallar — no existe en V2.

La V2 comprueba un permiso de aplicación en cada llamada — la V1 no comprobaba ninguno — y una llamada a la que le falte responde 400 con errorCode 15, el mismo estado que un payload inválido (ver 4.4). Dáselos al usuario de API antes de portar el comando; los nombres son los del árbol de permisos de flowww.

LlamadaPermiso
POST /order/{orderGID}/num/{orderGPartNum}/sendControl de stock - Pedidos → Enviar productos a la clínica
PATCH /order/{orderGID}/num/{orderGPartNum}Control de stock - Pedidos → Guardar
DELETE /order/{orderGID}/num/{orderGPartNum}/receiveControl de stock - Pedidos → Pedidos - Anular recepción de pedidos
GET /order/1/num/0Control de stock - Pedidos → Ver
GET /orderControl de stock - Pedidos → Listar
API V1 — una llamada
curl --location 'https://euapi.flowww.net/v1/fwa_external_get.asp?cmd=103&doctor=USER_LOGIN&pass=USER_PASS&country=ES&key=SYSTEM_KEY&ClinicID=1' \
--data-urlencode 'OrderGID=1' \
--data-urlencode 'OrderGPartNum=0' \
--data-urlencode 'OrderDetails[]=1,10' \
--data-urlencode 'OrderDetails[]=2,0' \
--data-urlencode 'OrderAutomatic=1'
API V2 — 1. Comprueba el pedido
curl --location 'https://api.flowww.net/v2/order/1/num/0?clinicID=1' \
--header 'Authorization: Bearer <api_key>'

Sirve solo partes de pedido que estén aceptadas (PROCESSED) y aún no servidas.

2. Sírvelo
curl --location --request POST 'https://api.flowww.net/v2/order/1/num/0/send?clinicID=1' \
--header 'Authorization: Bearer <api_key>'
3. Confirma
curl --location 'https://api.flowww.net/v2/order?clinicID=1&orderState=2' \
--header 'Authorization: Bearer <api_key>'

La parte servida aparece ya como SENT_TO_CLINIC, y surge una parte nueva con todo lo que estaba sin stock.

API V1API V2Notas
OrderGID, OrderGPartNumsegmentos de la ruta—
OrderAutomatic=1POST …/sendSiempre este modo: servir lo que haya en stock y mover el resto a una parte nueva.
OrderAutomatic=0 + OrderDetails[]=orderID,unidades—Hueco: no puedes elegir las unidades a servir por línea. Y no cambies las unidades de la línea con PATCH …/detail/{orderID} para esto: eso cambia la cantidad pedida de forma definitiva.
el envío en síPOST …/sendCuidado: un GET sobre la misma ruta es otra operación distinta — envía el pedido a la central de compras, que es lo que hace la clínica al cursarlo.
TemaAPI V1API V2
Condiciones previasSolo se podían servir pedidos aceptados (108004), y nunca más unidades de las pedidas (108012).No se comprueban. La V2 no verifica que la parte estuviera aceptada, ni que no se hubiera servido ya. Comprueba siempre el pedido antes (paso 1) y no repitas nunca la llamada: servir dos veces descuenta el stock dos veces.
Sin stock108004, y no se servía nada (modo manual).Se sirve lo que hay en stock; el resto pasa a una parte nueva. 400 no-stock solo cuando no se puede servir absolutamente nada.
Central de compras—Si el centro del pedido no está configurado como central de compras, la llamada no hace nada y aún así responde 200: el paso 3 lo delata.
ProveedoresLas líneas de proveedor externo iban a su propia parte y se enviaba un correo al proveedor.Igual.
  • Recepción en la clínica: PATCH /order/{orderGID}/num/{orderGPartNum} con las unidades recibidas por línea. Añade las unidades al stock de la clínica y cierra la parte; las unidades no recibidas pasan a una parte nueva. No la llames nunca antes de haber servido el pedido. Una parte cerrada responde 400 559.
  • Deshacer una recepción: DELETE /order/{orderGID}/num/{orderGPartNum}/receive saca las unidades del stock de la clínica y reabre el pedido. El usuario de API necesita el permiso de anular recepción (400 548 si no).