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.
Permisos
Sección titulada «Permisos»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.
| Llamada | Permiso |
|---|---|
POST /order/{orderGID}/num/{orderGPartNum}/send | Control de stock - Pedidos → Enviar productos a la clínica |
PATCH /order/{orderGID}/num/{orderGPartNum} | Control de stock - Pedidos → Guardar |
DELETE /order/{orderGID}/num/{orderGPartNum}/receive | Control de stock - Pedidos → Pedidos - Anular recepción de pedidos |
GET /order/1/num/0 | Control de stock - Pedidos → Ver |
GET /order | Control de stock - Pedidos → Listar |
El flujo
Sección titulada «El flujo»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'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.
curl --location --request POST 'https://api.flowww.net/v2/order/1/num/0/send?clinicID=1' \ --header 'Authorization: Bearer <api_key>'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.
Mapeo de campos
Sección titulada «Mapeo de campos»| API V1 | API V2 | Notas |
|---|---|---|
OrderGID, OrderGPartNum | segmentos de la ruta | — |
OrderAutomatic=1 | POST …/send | Siempre 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 …/send | Cuidado: 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. |
Qué cambia respecto a V1
Sección titulada «Qué cambia respecto a V1»| Tema | API V1 | API V2 |
|---|---|---|
| Condiciones previas | Solo 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 stock | 108004, 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. |
| Proveedores | Las líneas de proveedor externo iban a su propia parte y se enviaba un correo al proveedor. | Igual. |
El resto del ciclo
Sección titulada «El resto del ciclo»- 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 responde400559. - Deshacer una recepción:
DELETE /order/{orderGID}/num/{orderGPartNum}/receivesaca las unidades del stock de la clínica y reabre el pedido. El usuario de API necesita el permiso de anular recepción (400548si no).