Ir al contenido

Comando 39 — Crear pedidos de productomultipaso

Una llamada de la V1 pasa a ser varias de la 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/0/detail/product/{productID}Control de stock - Pedidos → Añadir producto
POST /order/{orderGID}/num/0/sendControl de stock - Pedidos → Enviar productos a la clínica
POST /orderControl de stock - Pedidos → Crear
DELETE /order/{orderGID}/num/{orderGPartNum}Control de stock - Pedidos → Borrar
POST /order/{orderGID}/cloneControl de stock - Pedidos → Clonar pedidos
PUT /orderControl de stock - Pedidos → Pedidos automáticos
GET /orderControl de stock - Pedidos → Listar
GET /order/246/num/0/sendControl de stock - Pedidos → Enviar pedidos a la central
  • 1POST /order?clinicID={n}
    Crea el pedido, vacío → {"OrderGID": 246}
    La única llamada del cmd 39
  • 2POST /order/{orderGID}/num/0/detail/product/{productID}
    Una vez por línea, con {"OrderProductUnits": n}
    Products[]=id,unidades,precio
  • 3POST /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:

API V1 — una 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>
API V2 — 1. Crea un pedido vacío para la clínica
curl --location --request POST 'https://api.flowww.net/v2/order?clinicID=1' \
--header 'Authorization: Bearer <api_key>'
→ { "OrderGID": 246 }
2. Añade una línea por producto
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}'
3. Cúrsalo a la central de compras
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.

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.

Abandonar un pedido
curl --location --request DELETE 'https://api.flowww.net/v2/order/246/num/0?clinicID=1' --header 'Authorization: Bearer <api_key>'
RespuestaQué significa
404 (errorCode 241)No hay pedido con ese id y número de parte.
API V1API V2Notas
ClinicID?clinicID= en POST /orderLa clínica que pide. Tiene que tener una central de compras asignada.
Products[], 1.ª posición (id de producto){productID} en la rutaEl producto de la tarifa de la clínica; se casa con la tarifa de la central de compras.
Products[], 2.ª posición (unidades)OrderProductUnitsEnví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>OrderGIDNúmero de parte 0 hasta que el pedido se divida.
TemaAPI V1API V2
EnvíoAutomático, desde la central de compras (ver arriba).Llamadas aparte.
AtomicidadUn 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 vecesDos 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.
ProveedoresLas 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.
PasoRespuestaQué significaQué hacer
1400 242La 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.
3400 238Pedido o producto no encontrados, o el producto no está en la tarifa de la central de compras.Revisa el producto.
3400 520Más unidades de las que el producto permite por pedido.Divide el pedido.
3400Comentarios de más de 150 caracteres.Acórtalos.
cualquiera400 (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.