{"info":{"_postman_id":"8c32a613-753a-4f20-96f4-c25527274894","name":"Pharmacy","description":"

El servicio de Surtimiento de Recetas electrónicas de Medikit, tiene como objetivo que la farmacia surta la receta con apego a políticas.

Es un servicio web que expone los métodos para consultar y validar Recetas y medicamentos emitidos por el sistema Medikit, así como para marcar medicamentos con el estatus de “surtido” para ser consumido por Farmacias con un convenio de surtimiento.

Es importante mencionar que todos los datos que se describen en cada una de las operaciones son obligatorios.

Es necesario tener un contrato activo con Medikit para obtener los datos productivos.
Comunicarse con tania.marcos@medikit.mx para obtener sus credenciales productivas.

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"15126185","collectionId":"8c32a613-753a-4f20-96f4-c25527274894","publishedId":"Uyr7HyZM","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2022-04-19T16:44:16.000Z"},"item":[{"name":"DatosReceta","id":"f932a6f0-9c8f-41b1-a634-3b36bcfc6a34","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"API-KEY","value":"a57b8608-76ec-4ec6-8459-fd2e8d962db2","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"NUR\":\"991184888722\"\r\n}\r\n"},"url":"https://Medikit519203.jitterbit.net/UAT/1/pharmacy","description":"

Servicio para recepción de datos generales de la receta que incluye información de la empresa administradora, del médico, paciente y el listado de prescripciones; al enviar cualquier NUR de la receta como parámetro de entrada.

Request:

Enviar cualquier NUR de la receta como parámetro de entrada.

NUR: Número único de referencia por partida del medicamento. El NUR está representado como un código de barras por cada prescripción en la presentación impresa o PDF de la receta.

Response Exitoso:

Al enviar cualquier NUR de la receta como parámetro de entrada y que este exista en la base de datos responde con la siguiente información:

Datos de la empresa administradora:

RFC: RFC de la empresa Administradora.
PlanSalud: Identificador del Plan Salud proporcionado por Medikit.Sirve para subclasificar recetas y actividades de la Administradora.
Empresa: Nombre de la empresa pagadora
Administradora: Identificador de convenio comercial, entregado por Medikit.
IndicadorDePago: Es el número de indicador de pago en donde 1 es contado, 2 crédito y 3 copago.

Datos generales de la receta:

NombreMedico: Nombre del médico registrado.
Cedula: Número de cédula del médico ha registrado.
Especialidad: Especialidad médica registrada.
NumeroAutorizacion: Identificador de la receta.
NombrePaciente: Nombre del paciente registrado, este puede ser genérico si así fue registrado.
NumeroPaciente: Identificador del paciente.

Datos en formato de lista NURS:

Surtido: Si el valor es TRUE indica que ya fue surtido o no esta vigente para surtimiento y cuando es FALSE es que aún no ha sido surtido y esta vigente para surtimiento el medicamento.
NUR: Número único de referencia por partida del medicamento.
Medicamento: Nombre del medicamento.
EAN: Código EAN de Barras del medicamento.
Cantidad: Número de piezas disponibles para surtir.

Error: Indica como “OK”.

Response No Exitoso:

Al enviar cualquier NUR de la receta como parámetro de entrada y que este no exista en la base de datos responde un error con la siguiente información:

Error: En este parámetro devuelve en formato de texto cualquiera de los siguientes tipos de errores.

\"NUR Invalido\": El NUR no existe en la base de datos.

\n","urlObject":{"protocol":"https","path":["UAT","1","pharmacy"],"host":["Medikit519203","jitterbit","net"],"query":[],"variable":[]}},"response":[{"id":"4223b926-4d1c-41b2-be95-daa979947e83","name":"Ej. Respuesta exitosa","originalRequest":{"method":"GET","header":[{"key":"API-KEY","value":"a57b8608-76ec-4ec6-8459-fd2e8d962db2","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"NUR\":\"991184888722\"\r\n}\r\n"},"url":"https://Medikit519203.jitterbit.net/UAT/1/pharmacy"},"status":"OK","code":200,"_postman_previewlanguage":"plain","header":[{"key":"Date","value":"Tue, 24 May 2022 22:08:14 GMT"},{"key":"Content-Type","value":"text/plain"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, PATCH, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"Origin,authorization,Accept,DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type"},{"key":"Access-Control-Max-Age","value":"1800"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"RFC\": \"OLI171026S1A\",\n \"PlanSalud\": \"0Sb8c000000TOYDCA4\",\n \"NURS\": [\n {\n \"Surtido\": false,\n \"NUR\": \"991396728272\",\n \"Medicamento\": \"Aspirina Protect 100 mg Caja Con 28 Tabletas\",\n \"EAN\": \"7501318612655\",\n \"Cantidad\": 2\n },\n {\n \"Surtido\": false,\n \"NUR\": \"991433337121\",\n \"Medicamento\": \"Tempra 500 mg con 20 Tabletas\",\n \"EAN\": \"7501095452147\",\n \"Cantidad\": 2\n }\n ],\n \"NumeroPaciente\": \"99999\",\n \"NumeroAutorizacion\": \"CE220524000290\",\n \"NombrePaciente\": \"PatientParticular PatientLastnameParticular\",\n \"NombreMedico\": \"DoctorMayo11 DoctorLastnameMayo11\",\n \"IndicadorDePago\": 1,\n \"Especialidad\": \"Ginecología Y Obstetricia\",\n \"Error\": \"OK\",\n \"Empresa\": \"Medikit\",\n \"Cedula\": \"18052201\",\n \"Administradora\": \"Medikit\"\n}"},{"id":"4044bc08-fd1c-4475-b998-a0eff8a79825","name":"Ej. Respuesta no exitosa","originalRequest":{"method":"GET","header":[{"key":"API-KEY","value":"a57b8608-76ec-4ec6-8459-fd2e8d962db2","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"NUR\":\"881396728888\"\r\n}\r\n"},"url":"https://Medikit519203.jitterbit.net/UAT/1/pharmacy"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 24 May 2022 22:09:37 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, PATCH, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"Origin,authorization,Accept,DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type"},{"key":"Access-Control-Max-Age","value":"1800"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"Error\": \"NUR Invalido (no encontrado)\"\n}"}],"_postman_id":"f932a6f0-9c8f-41b1-a634-3b36bcfc6a34"},{"name":"SurtirReceta","id":"4fc5f361-1e57-4b3a-8c05-c2bfc57aeea0","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PUT","header":[{"key":"API-KEY","value":"a57b8608-76ec-4ec6-8459-fd2e8d962db2","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"NURS\":[\r\n {\r\n \"Provider\":\"0018c000029lUo1AAE\",\r\n \"PrecioBruto\":\"80.00\",\r\n \"PMP\":\"120.00\",\r\n \"Cantidad\":1,\r\n \"NUR\":\"991937179721\",\r\n \"NumeroTicket\":\"V1234\",\r\n \"NumeroSucursal\":\"112\",\r\n \"NombreSucursal\":\"Revolución\",\r\n \"IDIVA\":true,\r\n \"FechaSurtido\":\"2021-04-12 09:02:00\",\r\n \"EAN\":\"4598764321\"\r\n },\r\n {\r\n \"Provider\":\"0018c000029lUo1AAE\",\r\n \"PrecioBruto\":\"90.00\",\r\n \"PMP\":\"110.00\",\r\n \"Cantidad\":1,\r\n \"NUR\":\"415644318458\",\r\n \"NumeroTicket\":\"V1234\",\r\n \"NumeroSucursal\":\"112\",\r\n \"NombreSucursal\":\"Revolución\",\r\n \"IDIVA\":false,\r\n \"FechaSurtido\":\"2021-04-12 09:01:00\",\r\n \"EAN\":\"459087655543\"\r\n }\r\n ] \r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://Medikit519203.jitterbit.net/UAT/1/pharmacy","description":"

PUT PutSurtirReceta

Servicio para surtir el medicamento y recibir confirmación del sistema de surtimiento exitoso. Una vez comprobado que el NUR del medicamento es válido, se surte el medicamento y se marca como surtido.

Request:

Para surtir la prescripción la farmacia envía la siguiente información en formato de lista:

Datos de la prescripción surtida:

NUR: Número único de referencia de la partida del medicamento.
Fecha Surtido: Fecha de surtimiento en formato aaaa-mm-dd hr:mm:ss.
EAN: Código EAN de Barras del medicamento escaneado/tecleado.
Cantidad: Cantidad de piezas surtidas.
PrecioBruto: Precio bruto unitario del medicamento.
PMP: Precio máximo al público del medicamento. (unitario)
IDIVA: Es el indicador de IVA, si el valor es TRUE indica que lleva IVA y si el valor es FALSE no lleva IVA.
Datos de la sucursal surtidora:
Provider: Identificador de cuenta proporcionado por Medikit en el contrato. Este campo es fijo.
NumeroSucursal: Número de la sucursal en donde se surtió el medicamento.
NombreSucursal: Nombre de la sucursal en donde se surtió el medicamento.
NumeroTicket: Número del ticket en donde se surtió el medicamento.

Respuesta Exitosa:

Devuelve en formato de lista los NURS surtidos así como su estatus (surtimiento exitoso)

NUR: Número único de referencia por partida del medicamento.
Idaut: Número de autorización por NUR surtido.
Error: OK

Respuesta No Exitosa:

Devuelve en formato de lista los NURS no surtidos así como su motivo de no surtimiento.

NUR: Número único de referencia por partida del medicamento.
Idaut: null
Error:
- \"NUR Invalido (no encontrado)\": No se encuentra en la base de datos.
- \"NUR no vigente para surtimiento\": Desea surtir un medicamento que ya ha sido surtido o que no esta vigente para surtimiento.
- \"Excede la cantidad disponible a surtir\": Desea surtir un medicamento con mayor número de piezas disponibles a surtir.
\n

\n","urlObject":{"protocol":"https","path":["UAT","1","pharmacy"],"host":["Medikit519203","jitterbit","net"],"query":[],"variable":[]}},"response":[{"id":"ca8a1611-6a4f-4180-9335-9b3dc2a7615e","name":"Ej. Respuesta exitosa","originalRequest":{"method":"PUT","header":[{"key":"API-KEY","value":"a57b8608-76ec-4ec6-8459-fd2e8d962db2","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"NURS\":[\r\n {\r\n \"Provider\":\"0018c000029lUo1AAE\",\r\n \"PrecioBruto\":\"80.00\",\r\n \"PMP\":\"120.00\",\r\n \"Cantidad\":1,\r\n \"NUR\":\"991396728272\",\r\n \"NumeroTicket\":\"V1234\",\r\n \"NumeroSucursal\":\"999\",\r\n \"NombreSucursal\":\"Monterrey\",\r\n \"IDIVA\":true,\r\n \"FechaSurtido\":\"2022-05-24 09:02:00\",\r\n \"EAN\":\"7501318612655\"\r\n },\r\n {\r\n \"Provider\":\"0018c000029lUo1AAE\",\r\n \"PrecioBruto\":\"90.00\",\r\n \"PMP\":\"110.00\",\r\n \"Cantidad\":1,\r\n \"NUR\":\"991433337121\",\r\n \"NumeroTicket\":\"V1234\",\r\n \"NumeroSucursal\":\"112\",\r\n \"NombreSucursal\":\"Revolución\",\r\n \"IDIVA\":false,\r\n \"FechaSurtido\":\"2021-04-12 09:01:00\",\r\n \"EAN\":\"7501095452147\"\r\n }\r\n ] \r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://Medikit519203.jitterbit.net/UAT/1/pharmacy"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 24 May 2022 22:11:19 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, PATCH, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"Origin,authorization,Accept,DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type"},{"key":"Access-Control-Max-Age","value":"1800"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"NURS\": [\n {\n \"NUR\": \"991396728272\",\n \"IdAut\": \"0NBq00000004CESGA2\",\n \"Error\": \"OK\"\n },\n {\n \"NUR\": \"991433337121\",\n \"IdAut\": \"0NBq00000004CEXGA2\",\n \"Error\": \"OK\"\n }\n ]\n}"},{"id":"baf67b74-ca4f-4bd8-bb43-7e3296df5f2d","name":"Ej. Respuesta no exitosa","originalRequest":{"method":"PUT","header":[{"key":"API-KEY","value":"a57b8608-76ec-4ec6-8459-fd2e8d962db2","type":"text"}],"body":{"mode":"raw","raw":"{\r\n \"NURS\":[\r\n {\r\n \"Provider\":\"0018c000029lUo1AAE\",\r\n \"PrecioBruto\":\"80.00\",\r\n \"PMP\":\"120.00\",\r\n \"Cantidad\":3,\r\n \"NUR\":\"991396728272\",\r\n \"NumeroTicket\":\"V1234\",\r\n \"NumeroSucursal\":\"999\",\r\n \"NombreSucursal\":\"Monterrey\",\r\n \"IDIVA\":true,\r\n \"FechaSurtido\":\"2022-05-24 09:02:00\",\r\n \"EAN\":\"7501318612655\"\r\n }\r\n ] \r\n}\r\n","options":{"raw":{"language":"json"}}},"url":"https://Medikit519203.jitterbit.net/UAT/1/pharmacy"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Date","value":"Tue, 24 May 2022 22:12:19 GMT"},{"key":"Content-Type","value":"application/json"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Connection","value":"keep-alive"},{"key":"Vary","value":"Accept-Encoding"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, PUT, PATCH, OPTIONS"},{"key":"Access-Control-Allow-Headers","value":"Origin,authorization,Accept,DNT,X-CustomHeader,Keep-Alive,User-Agent,X-Requested-With,If-Modified-Since,Cache-Control,Content-Type"},{"key":"Access-Control-Max-Age","value":"1800"},{"key":"Content-Encoding","value":"gzip"}],"cookie":[],"responseTime":null,"body":"{\n \"NURS\": [\n {\n \"NUR\": \"991396728272\",\n \"IdAut\": null,\n \"Error\": \"Excede la cantidad disponible a surtir\"\n }\n ]\n}"}],"_postman_id":"4fc5f361-1e57-4b3a-8c05-c2bfc57aeea0"},{"name":"Cancelar","id":"da930bfd-8a97-40fe-bd6a-672ac417a411","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"PATCH","header":[{"key":"API-KEY","value":"a57b8608-76ec-4ec6-8459-fd2e8d962db2","type":"text"}],"body":{"mode":"raw","raw":"{\r\n\"NURS\":[\r\n {\r\n \"NUR\":\"116522291400\",\r\n \"NumeroTicket\":\"V1234\",\r\n \"NumeroSucursal\":\"999\",\r\n \"NombreSucursal\":\"Monterrey\",\r\n \"FechaCancelacion\":\"2022-05-24 09:02:00\",\r\n \"EAN\":\"4598764321\"\r\n },\r\n {\r\n \"NUR\":\"415644318458\",\r\n \"NumeroTicket\":\"V1234\",\r\n \"NumeroSucursal\":\"999\",\r\n \"NombreSucursal\":\"Monterrey\",\r\n \"FechaCancelacion\":\"2022-05-24 09:02:00\",\r\n \"EAN\":\"459087655543\"\r\n }\r\n]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://Medikit519203.jitterbit.net/UAT/1/pharmacy","description":"

PATCH PatchCancelar

Servicio opcional para cancelar el surtimiento del servicio (registrar un medicamento ya surtido como no surtido), es decir cuando se realiza alguna devolución, sin embargo nos regimos sobre las políticas que tengan como empresa y para los casos en el que por alguna razón el operador del punto de venta cometió un error al indicar un medicamento como surtido cuando realmente no lo fue.

En caso de que la información del NUR enviado que se solicite cancelar no coincida con el que se envió previamente, no podrá ser cancelado.

Request:

Enviar los siguientes datos en formato de lista:

NUR: Número único de referencia de la partida del medicamento.
NumeroTicket: Número del ticket de donde se surtió el medicamento.
NumeroSucursal: Número de la sucursal en donde se surtió el medicamento.
NombreSucursal: Nombre de la sucursal en donde se surtió el medicamento.
FechaCancelacion: Fecha de cancelación en formato aaaa-mm-dd hr:mm:ss\"
EAN: Código EAN de Barras del medicamento escaneado/tecleado.

Respuesta Exitosa:

Devuelve en formato de lista los NURS que se solicitaron cancelar así como su estatus de cancelación exitosa

NUR: Número único de referencia por partida del medicamento.
Idaut: Número de autorización por NUR cancelado.
Error: OK

Respuesta No Exitosa:

Devuelve en formato de lista los NURS que se solicitaron cancelar así como su estatus del motivo de la cancelación NO exitosa:

NUR: Número único de referencia por partida del medicamento.
Idaut: null
Error:
- \"NUR Invalido (no encontrado)\" : No se encuentra en la base de datos.
- \"El estatus del NUR no permite la cancelación\": Deseas cancelar un medicamento que no ha sido surtido, no esta vigente o ya fue facturado.
\n