Comando 39 — Crear pedidos de productomultipaso
Una llamada de la V1 pasa a ser varias de la 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/0/detail/product/{productID} | Control de stock - Pedidos → Añadir producto |
POST /order/{orderGID}/num/0/send | Control de stock - Pedidos → Enviar productos a la clínica |
POST /order | Control de stock - Pedidos → Crear |
DELETE /order/{orderGID}/num/{orderGPartNum} | Control de stock - Pedidos → Borrar |
POST /order/{orderGID}/clone | Control de stock - Pedidos → Clonar pedidos |
PUT /order | Control de stock - Pedidos → Pedidos automáticos |
GET /order | Control de stock - Pedidos → Listar |
GET /order/246/num/0/send | Control de stock - Pedidos → Enviar pedidos a la central |
El flujo
Sección titulada «El flujo»- 1
POST /order?clinicID={n}
Crea el pedido, vacío →{"OrderGID": 246}
La única llamada del cmd 39 - 2
POST /order/{orderGID}/num/0/detail/product/{productID}
Una vez por línea, con{"OrderProductUnits": n}
Products[]=id,unidades,precio - 3
POST /order/{orderGID}/num/0/send
Lo cursa a la central de compras
Automático — la V1 lo cursaba por ti
El mismo pedido, llamada a llamada:
curl --location 'https://euapi.flowww.net/v1/fwa_external_get.asp?cmd=39&doctor=USER_LOGIN&pass=USER_PASS&country=ES&key=SYSTEM_KEY&ClinicID=1' \ --data-urlencode 'Products[]=178,3,29.99' \ --data-urlencode 'Products[]=589,2'
<Cmd39><Result>1</Result> <Order><Id>246</Id></Order></Cmd39>curl --location --request POST 'https://api.flowww.net/v2/order?clinicID=1' \ --header 'Authorization: Bearer <api_key>'
→ { "OrderGID": 246 }curl --location 'https://api.flowww.net/v2/order/246/num/0/detail/product/178?clinicID=1' \ --header 'Authorization: Bearer <api_key>' \ --header 'Content-Type: application/json' \ --data '{"OrderProductUnits": 3}'
curl --location 'https://api.flowww.net/v2/order/246/num/0/detail/product/589?clinicID=1' \ --header 'Authorization: Bearer <api_key>' \ --header 'Content-Type: application/json' \ --data '{"OrderProductUnits": 2}'curl --location 'https://api.flowww.net/v2/order/246/num/0/send?clinicID=1' \ --header 'Authorization: Bearer <api_key>'Para reproducir lo que hacía la V1, la central lo acepta después y lo sirve: ver comando 102 y comando 103.
Limpiar tras un fallo
Sección titulada «Limpiar tras un fallo»Como la venta, un pedido se monta en varias llamadas, y un fallo a medias lo deja ahí: creado y, según dónde falles, con parte de sus líneas y sin cursar. Guárdate el OrderGID que devuelve el paso 1 antes de seguir: es lo que te deja volver a él para terminarlo o para borrarlo.
DELETE /order/{orderGID}/num/{orderGPartNum} lo elimina con sus líneas: borra el detalle y la cabecera de una vez y, a diferencia del borrado de facturas, no exige vaciarlo antes.
curl --location --request DELETE 'https://api.flowww.net/v2/order/246/num/0?clinicID=1' --header 'Authorization: Bearer <api_key>'| Respuesta | Qué significa |
|---|---|
404 (errorCode 241) | No hay pedido con ese id y número de parte. |
Mapeo de campos
Sección titulada «Mapeo de campos»| API V1 | API V2 | Notas |
|---|---|---|
ClinicID | ?clinicID= en POST /order | La clínica que pide. Tiene que tener una central de compras asignada. |
Products[], 1.ª posición (id de producto) | {productID} en la ruta | El producto de la tarifa de la clínica; se casa con la tarifa de la central de compras. |
Products[], 2.ª posición (unidades) | OrderProductUnits | Envía un entero mayor que 0: un valor ausente o inválido se cambia a 1 sin dar error (la V1 lo rechazaba). |
Products[], 3.ª posición (precio de coste) | — | Hueco: no se acepta. El precio de coste sale del ajuste de la clínica origen del precio de compra (precio de la central, precio medio ponderado o coste propio de la clínica). |
<Order><Id> | OrderGID | Número de parte 0 hasta que el pedido se divida. |
Qué cambia respecto a V1
Sección titulada «Qué cambia respecto a V1»| Tema | API V1 | API V2 |
|---|---|---|
| Envío | Automático, desde la central de compras (ver arriba). | Llamadas aparte. |
| Atomicidad | Un producto desconocido cancelaba el pedido entero. | Cada línea se guarda por su cuenta: un producto desconocido solo hace fallar esa línea, y el pedido se queda con las demás. |
| El mismo producto dos veces | Dos líneas. | Las unidades se suman a la línea existente cuando el producto y su coste coinciden. |
| Líneas en un pedido ya cursado | — | Se aceptan: la V2 no comprueba el estado del pedido. Añade líneas solo a pedidos pendientes. |
| Proveedores | Las líneas de productos de proveedor externo iban a su propia parte del pedido y se enviaba un correo al proveedor. | Igual, cuando el pedido se sirve. |
Errores
Sección titulada «Errores»| Paso | Respuesta | Qué significa | Qué hacer |
|---|---|---|---|
1 | 400 242 | La clínica del clinicID que enviaste no tiene central de compras. | Asignásela en la aplicación, o llama desde una que sí la tenga. No se ha creado nada. |
3 | 400 238 | Pedido o producto no encontrados, o el producto no está en la tarifa de la central de compras. | Revisa el producto. |
3 | 400 520 | Más unidades de las que el producto permite por pedido. | Divide el pedido. |
3 | 400 | Comentarios de más de 150 caracteres. | Acórtalos. |
| cualquiera | 400 (errorCode 15) | El usuario de API no tiene los permisos de Control de stock → Pedidos. | Concédeselos. |
Si el flujo falla a medias, borra el pedido incompleto con DELETE /order/{orderGID}/num/{orderGPartNum}, o complétalo al reintentar — no crees uno nuevo.
Novedades de la V2 que conviene conocer: POST /order/{orderGID}/clone replica un pedido en otras clínicas, y PUT /order genera pedidos automáticos.