Diferencia entre revisiones de «API LaFactura.co:Usuarios.ms»

De API LaFactura.co
Ir a la navegación Ir a la búsqueda
(Página creada con «==Objeto:usuarios.ms== Es un objeto usado en invoicems. Contiene el detalle de los datos de los usarios. =====Ejemplo===== "items":…»)
 
 
(No se muestran 50 ediciones intermedias del mismo usuario)
Línea 1: Línea 1:
 
==Objeto:usuarios.ms==
 
==Objeto:usuarios.ms==
  
−
Es un objeto usado en [[API_laFactura.co:invoice.ms|invoicems]]. Contiene el detalle de los datos de los usarios.
+
Es un objeto usado en [[API_laFactura.co:invoice|invoice/additional]]. Contiene el detalle de los datos de los usarios segun lo requerido por el Ministerio de Salud
  
 
=====Ejemplo=====
 
=====Ejemplo=====
  
−
       "items":[
+
       "usuarios.ms":[
−
        {
+
          {
−
          "quantity":"5.00",
+
            "prestador":"984350983",
−
          "unitPrice":"20000.00",
+
            "tipoDoc":"CC",
−
          "total":"96000.00",
+
            "numDoc":"51890041",
−
          "description":"Horas de soporte remoto",
+
            "primerApellido":"PEREZ",
−
          "brand":"LF",
+
            "segundoApellido":"PERALTA",
−
          "model":"Soporte",
+
            "primerNombre":"PEPITA",
−
          "standard": "999",
+
            "otrosNombre":"",
−
          "agency": "990",
+
            "tipoUsuario":"01",
−
          "code": "1000",
+
            "tipoContrato":"12",
−
          "allowance":[
+
            "tipoPlan":"11",
−
                {
+
            "numAutorizacion":"202020",
−
                  "charge":"false",
+
            "numMIPRES":"",
−
                  "reasonCode":"11",
+
            "IDMIPRES":"",
−
                  "description":"Es un super descuento por hoy",
+
            "numContrato":"CRT0934094",
−
                  "baseAmount":"100000.00",
+
            "numPoliza":""
−
                  "amount":"4000.00",
+
           }
−
                  "percent":"4.00"
+
        ]
−
                }                   
 
−
          ],
 
−
          "taxes":[
 
−
                {
 
−
                  "ID":"01",
 
−
                  "taxAmount":"18240.00",
 
−
                  "percent":"19.00"
 
−
                }
 
−
            ]
 
−
        },
 
−
        {
 
−
           "quantity":"1.00",
 
−
          "unitPrice":"20000.00",
 
−
          "total":"20000.00",
 
−
          "description":"Servicio sin IVA",
 
−
          "brand":"LF",
 
−
          "model":"Serv1",
 
−
          "standard": "999",
 
−
          "agency": "990",
 
−
          "code": "1"
 
−
        }
 
−
      ]
 
  
 
=====Explicacion=====
 
=====Explicacion=====
−
 
−
Se están facturando 2 Items:
 
−
 
−
Item 1:
 
−
*Cantidad: 5.00
 
−
*Precio Unitario: 20000.00
 
−
*Total de la linea: 96000.00 (Tener presente cargos, descuentos e impuestos)
 
−
*descripcion: Horas de soporte remoto
 
−
*marca: LF
 
−
*modelo: Soporte
 
−
*standard del codigo del producto: 999 (propio)
 
−
*agencia que se encarga del standard: 990 (para el standard propio, puede ser cualquier numero)
 
−
*código del producto en dicho standard: 1000
 
−
*cargos y descuentos (mirar el objeto interno para explicacion)
 
−
*impuestos (mirar el objeto interno para explicacion)
 
−
 
−
Item 2:
 
−
*cantidad: 1
 
−
*precio unitario: 20000.00
 
−
*descripcion: Servicio sin IVA
 
−
*marca: LF
 
−
*modelo: Serv1
 
−
*standard": 999
 
−
*agencia que se encarga del standard: 990
 
−
*código del producto en dicho standard: 1<br/>
 
  
 
=====Campos=====
 
=====Campos=====
Línea 80: Línea 33:
 
! Parámetro !! Descripción !! Tipo !! Obligatorio
 
! Parámetro !! Descripción !! Tipo !! Obligatorio
 
|-
 
|-
−
| quantity || Cantidad vendida<br><small>(Debe incluir dos decimales)</small>|| cadena || SI
+
| prestador || Código asignado por el SGSSS o por el MSPS (Solo para inscritos en el REPS)<br/><small>Tener presente Pag 5, Resolución 000084 de 28 Enero de 2021</small>|| cadena || SI/NO
 +
|-
 +
| tipoDoc || Tipo de Documento de identificación<br><small>Tener presente Pag 5 y 6, Resolución 000084 de 28 Enero de 2021<BR/>[[API_LaFactura.co:Tabla tipoDoc.ms|Consultar tabla]] (Solo se aceptan los valores de dicha tabla)</small>|| cadena || SI
 +
|-
 +
| numDoc || Número De Identificación<br/><small>Tener presente Pag 6, Resolución 000084 de 28 Enero de 2021<BR/>(Alfanumerico sin puntos o espacios) min 3 - max 16</small>|| cadena || SI
 +
|-
 +
| primerApellido || Primer Apellido<br/><small>Tener presente Pag 6, Resolución 000084 de 28 Enero de 2021<br>(Alfanumerico)</small> || cadena || SI
 +
|-
 +
| segundoApellido || Segundo Apellido<br/><small>Tener presente Pag 6 y 7, Resolución 000084 de 28 Enero de 2021<br>(Alfanumerico) - De no tenerlo debe ser enviado en blanco</small> || cadena || SI
 +
|-
 +
| primerNombre || Primer Nombre<br/><small>Tener presente Pag 7, Resolución 000084 de 28 Enero de 2021<br/>(Alfanumerico)</small> || cadena || SI
 
|-
 
|-
−
| unitPrice || Precio unitario del articulo<br><small>(Debe incluir dos decimales)</small> || cadena || SI
+
| otrosNombre || Segundo Nombre<br><small>Tener presente Pag 7, Resolución 000084 de 28 Enero de 2021<br/>(Alfanumerico) - De no tenerlo debe ser enviado en blanco</small> || cadena || SI
 
|-
 
|-
−
| total || valor total del articulo<br><small>(quantity*unitPrice-descuentos+cargos, con dos decimales)</small> || cadena || SI
+
| tipoUsuario ||Tipo De Usuario<br><small>Tener presente Pag 7 y 8, Resolución 000084 de 28 Enero de 2021<BR/>[[API_LaFactura.co:Tabla tipoUsuario.ms|Consultar tabla]] (Solo se aceptan los valores de dicha tabla)</small> || cadena || SI
 
|-
 
|-
−
| description || Descripcion del producto completo || cadena || SI
+
| tipoContrato || Modalidad de contratación y pago<br><small>Tener presente Pag 8 a 10, Resolución 000084 de 28 Enero de 2021<BR/>[[API_LaFactura.co:Tabla tipoContrato.ms|Consultar tabla]] (Solo se aceptan los valores de dicha tabla)</small> || cadena || SI
 
|-
 
|-
−
| brand || Marca del producto || cadena || SI
+
| tipoPlan || Tipo De Plan<br><small>Tener presente Pag 10 a 12, Resolución 000084 de 28 Enero de 2021<BR/>[[API_LaFactura.co:Tabla tipoPlan.ms|Consultar tabla]] (Solo se aceptan los valores de dicha tabla)</small> || cadena || SI
 
|-
 
|-
−
| model || Modelo del producto || cadena || SI
+
| numAutorizacion || Numero De Autorización<br/><small>Tener presente Pag 12, Resolución 000084 de 28 Enero de 2021<br/>(Alfanumerico) - De no tener, debe ir en blanco </small>|| cadena || SI
 
|-
 
|-
−
| standard || Standard usado para codificar el producto<br/><small>001 -> UNSPSC<br/>010 -> GTIN<br/>020 -> Partida arancelaria<br/>999 -> Standard propio<br/>(Nuevo Obligatorio)</small> || cadena || SI
+
| numMIPRES || Número De MIPRES<br/><small>Tener presente Pag 12, Resolución 000084 de 28 Enero de 2021<br/>(Alfanumerico) - De no tener, debe ir en blanco </small>|| cadena || SI
 
|-
 
|-
−
| agency || Código de la agencia encargada de dicho standard<br/><small>10 -> Para standard 001<br/>9 -> Para standard 010<br/>195 -> para standard 020<br/>cualquier valor -> Para standard 999<br/>(Nuevo Obligatorio)</small> || cadena || SI
+
| IDMIPRES || Número De ID de suministro MIPRES<br/><small>Tener presente Pag 12 y 13, Resolución 000084 de 28 Enero de 2021<br/>(Alfanumerico) - De no tener, debe ir en blanco </small>|| cadena || SI
 
|-
 
|-
−
| code || Código unificado del producto, según standard seleccionado<br/><small>Para standard 001, 010 y 020 debe ser numérico<br/>Para standard 999 es alfanumérico - sin espacios</small>|| cadena || SI
+
| numContrato || Número De Contrato<br/><small>Tener presente Pag 13, Resolución 000084 de 28 Enero de 2021<br/>(Alfanumerico) - De no tener, debe ir en blanco </small> || cadena || SI
 
|-
 
|-
−
| allowance || Cargos o descuentos<br><small>(Deben estar incluidos si se aplica algún descuento en el item)<br>Ir a: [[API_LaFactura.co:Allowance|allowance]]</small> || objeto || SI/NO
+
| numPoliza || Número De Póliza<br/><small>Tener presente Pag 12 y 13, Resolución 000084 de 28 Enero de 2021<br/>(Alfanumerico) - De no tener, debe ir en blanco </small> || objeto || SI
 
|-
 
|-
−
| taxes || Impuestos calculados a nivel de producto<br><small>(Deben estar incluidos si se aplica algún impuesto en el item)<br>Ir a: [[API_LaFactura.co:Taxes|taxes]]</small> || objeto || SI/NO
+
| elaboradoPor || Elaborado Por || objeto || NO <small>(Será eliminado el 1 de Marzo 2.021)</small>
 
|}
 
|}
  
 
=====A Tener presente=====
 
=====A Tener presente=====
−
* Este objeto está '''SIEMPRE''' compuesto de arreglos, así solo se envíe 1 linea de detalle
+
* Este objeto está '''SIEMPRE''' compuesto de arreglos, así solo se envíe 1 usuario
  
 
==Objetos empleados==
 
==Objetos empleados==
−
*[[API_LaFactura.co:Allowance|allowance]] (Cargos y Descuentos)
 
−
*[[API_laFactura.co:taxes|taxes]] (Impuestos)
 
  
 
==Usado por==
 
==Usado por==
 
Los siguientes recursos:
 
Los siguientes recursos:
 
* [[API_LaFactura.co:Generar_Factura|Generar Factura]]
 
* [[API_LaFactura.co:Generar_Factura|Generar Factura]]
−
* [[API_LaFactura.co:Generar_Nota_Credito|Generar Nota Crédito]]
 
  
 
Los siguientes objetos:
 
Los siguientes objetos:
 
* [[API_laFactura.co:invoice|invoice]] (Factura)
 
* [[API_laFactura.co:invoice|invoice]] (Factura)
−
* [[API_laFactura.co:creditNote|creditNote]] (Nota Crédito)
 
  
 
==Temas complementarios==
 
==Temas complementarios==

Revisión actual del 22:47 2 feb 2021

Objeto:usuarios.ms

Es un objeto usado en invoice/additional. Contiene el detalle de los datos de los usarios segun lo requerido por el Ministerio de Salud

Ejemplo
     "usuarios.ms":[
          {
            "prestador":"984350983",
            "tipoDoc":"CC",
            "numDoc":"51890041",
            "primerApellido":"PEREZ",
            "segundoApellido":"PERALTA",
            "primerNombre":"PEPITA",
            "otrosNombre":"",
            "tipoUsuario":"01",
            "tipoContrato":"12",
            "tipoPlan":"11",
            "numAutorizacion":"202020",
            "numMIPRES":"",
            "IDMIPRES":"",
            "numContrato":"CRT0934094",
            "numPoliza":""
          }
       ]
Explicacion
Campos
Parámetro Descripción Tipo Obligatorio
prestador Código asignado por el SGSSS o por el MSPS (Solo para inscritos en el REPS)
Tener presente Pag 5, Resolución 000084 de 28 Enero de 2021		 cadena SI/NO
tipoDoc Tipo de Documento de identificación
Tener presente Pag 5 y 6, Resolución 000084 de 28 Enero de 2021
Consultar tabla (Solo se aceptan los valores de dicha tabla)		 cadena SI
numDoc Número De Identificación
Tener presente Pag 6, Resolución 000084 de 28 Enero de 2021
(Alfanumerico sin puntos o espacios) min 3 - max 16		 cadena SI
primerApellido Primer Apellido
Tener presente Pag 6, Resolución 000084 de 28 Enero de 2021
(Alfanumerico)		 cadena SI
segundoApellido Segundo Apellido
Tener presente Pag 6 y 7, Resolución 000084 de 28 Enero de 2021
(Alfanumerico) - De no tenerlo debe ser enviado en blanco		 cadena SI
primerNombre Primer Nombre
Tener presente Pag 7, Resolución 000084 de 28 Enero de 2021
(Alfanumerico)		 cadena SI
otrosNombre Segundo Nombre
Tener presente Pag 7, Resolución 000084 de 28 Enero de 2021
(Alfanumerico) - De no tenerlo debe ser enviado en blanco		 cadena SI
tipoUsuario Tipo De Usuario
Tener presente Pag 7 y 8, Resolución 000084 de 28 Enero de 2021
Consultar tabla (Solo se aceptan los valores de dicha tabla)		 cadena SI
tipoContrato Modalidad de contratación y pago
Tener presente Pag 8 a 10, Resolución 000084 de 28 Enero de 2021
Consultar tabla (Solo se aceptan los valores de dicha tabla)		 cadena SI
tipoPlan Tipo De Plan
Tener presente Pag 10 a 12, Resolución 000084 de 28 Enero de 2021
Consultar tabla (Solo se aceptan los valores de dicha tabla)		 cadena SI
numAutorizacion Numero De Autorización
Tener presente Pag 12, Resolución 000084 de 28 Enero de 2021
(Alfanumerico) - De no tener, debe ir en blanco 		cadena SI
numMIPRES Número De MIPRES
Tener presente Pag 12, Resolución 000084 de 28 Enero de 2021
(Alfanumerico) - De no tener, debe ir en blanco 		cadena SI
IDMIPRES Número De ID de suministro MIPRES
Tener presente Pag 12 y 13, Resolución 000084 de 28 Enero de 2021
(Alfanumerico) - De no tener, debe ir en blanco 		cadena SI
numContrato Número De Contrato
Tener presente Pag 13, Resolución 000084 de 28 Enero de 2021
(Alfanumerico) - De no tener, debe ir en blanco 		cadena SI
numPoliza Número De Póliza
Tener presente Pag 12 y 13, Resolución 000084 de 28 Enero de 2021
(Alfanumerico) - De no tener, debe ir en blanco 		objeto SI
elaboradoPor Elaborado Por objeto NO (Será eliminado el 1 de Marzo 2.021)
A Tener presente
  • Este objeto está SIEMPRE compuesto de arreglos, así solo se envíe 1 usuario

Objetos empleados

Usado por

Los siguientes recursos:

Los siguientes objetos:

Temas complementarios

Enlaces

Obtenido de «https://wiki.lafactura.co/index.php?title=API_LaFactura.co:Usuarios.ms&oldid=1110»