Diferencia entre revisiones de «Servicios Web»

De wiki
Saltar a: navegación, buscar
(Consultar documentos pendientes por cobrar)
Línea 72: Línea 72:
 
;documentPending : monto por cobrar de los documentos pendientes.
 
;documentPending : monto por cobrar de los documentos pendientes.
 
;documentWeightedDays : días promedio ponderados de los documentos pendientes.
 
;documentWeightedDays : días promedio ponderados de los documentos pendientes.
 +
;contactPhones : telefonos del contacto formateado como; '''tipo:numero''' y separados por el caracter ';'.
  
 
Un ejemplo de este resultado se vería así:
 
Un ejemplo de este resultado se vería así:
  
 
<pre>
 
<pre>
"12590","Organizacion Palo Alto, C.A.","7","503008.76000","376258.75000","332"
+
"12590","Organizacion Palo Alto, C.A.","7","503008.76000","376258.75000","332","work:0212 285 3348;mobile:04122345678"
"540","COMUNICACIONES SICA, C.A","1","484.96000","116.48000","6"
+
"540","COMUNICACIONES SICA, C.A","1","484.96000","116.48000","6","mobile:04122345678"
"406","RUSTI ACCESORIOS CORONA, C.A.","1","4693.92000","4693.92000","1"
+
"406","RUSTI ACCESORIOS CORONA, C.A.","1","4693.92000","4693.92000","1","home:0212-2345678"
"12594","DISTRIBUIDORA DE UÑAS L.N. 2008, C.A","2","7694.49000","1680.49000","0"
+
"12594","DISTRIBUIDORA DE UÑAS L.N. 2008, C.A","2","7694.49000","1680.49000","0","home:02122853348;mobile:04122345678"
"30229","FONDO DE INVERSIONES COMERCIAL AVILA, C.A","1","468.83000","468.83000","48"
+
"30229","FONDO DE INVERSIONES COMERCIAL AVILA, C.A","1","468.83000","468.83000","48",""
"33555","JOSE MIGUEL ORAA MALTESE","1","1625.12000","1625.12000","8"
+
"30675","VERA ROLDAN FERNANDO ANTONIO","1","890.40000","890.40000","41",""
"30675","VERA ROLDAN FERNANDO ANTONIO","1","890.40000","890.40000","41"
+
"12652","Lior Cosmetics, C.A.","11","150734.90000","150734.90000","466","mobile:04142345678"
"12652","Lior Cosmetics, C.A.","11","150734.90000","150734.90000","466"
+
"12556","EBANO GRUPO MODA, C.A.","1","104.16000","104.16000","468","mobile:04162345678"
"12556","EBANO GRUPO MODA, C.A.","1","104.16000","104.16000","468"
+
"1026","ADVENTURE EXTREME 4X4, C.A.","1","7618.24000","7618.24000","52",""
"1026","ADVENTURE EXTREME 4X4, C.A.","1","7618.24000","7618.24000","52"
+
"31469","TRAVELUSA TOURS VIAJES Y TURISMO C.A","1","97110.72000","39110.72000","49","mobile:04124545555;mobile:04122345678"
"31469","TRAVELUSA TOURS VIAJES Y TURISMO C.A","1","97110.72000","39110.72000","49"
+
"12634","LOYOLA SPORT CLUB","1","29691.23000","26981.23000","510","mobile:+584122345678"
"12634","LOYOLA SPORT CLUB","1","29691.23000","26981.23000","510"
+
"852","AUDIO CAR, C.A.","1","2222.08000","2222.08000","41","mobile:58-412-2345678"
"852","AUDIO CAR, C.A.","1","2222.08000","2222.08000","41"
+
 
</pre>
 
</pre>

Revisión de 12:34 23 dic 2010

NiMbox permite acceder ciertas de sus funcionalidades a través de servicios web. El punto de contacto de estos sitios web es la dirección segura https://host/direct/items. Los servicios web disponibles por el momento son:

Contenido

Agregar una nota

Es posible agregar notas a cualquiera de los elementos de datos representados en NiMbox. Los parámetros son:

thingyId
el elemento al cual conectarle la nota. Típicamente este elemento es un contacto.
contextName (opcional)
el nombre del contexto al cual conectarle la nota.
description
el contenido de la nota.

Para crear una nota

wget --user=jlopez --password=comic --no-check-certificate -qO- \
  "https://host/direct/items/notes/create?thingyId=24&description=La+nota+se+proceso+exitosamente"

En caso de éxito el resultado será un json parecido a este:

{
  'error' : false,
  'note' : {
    'id' : 34044,
    'description' : "La nota se proceso exitosamente",
    'sortDate' : new Date(2010,11,21,7,5,36),
    'createdOn' : new Date(2010,11,21,7,5,36),
    'createdBy' : "jlopez",
    'updatedOn' : new Date(2010,11,21,7,5,36),
    'updatedBy' : "jlopez"
    'deletedOn' : null,
    'deletedBy' : null,
  }
}

En caso de error el resultado será un json parecido a este:

{
  'errors' : {
    'thingyId' : "nota no está relacionada con ningún objeto"
    'description' : "descripción está vacía",
  },
  'error' : true
}

Agregar una tarea

Completar una tarea

Consultar documentos pendientes por cobrar

Para consultar los documentos pendientes, en formato separado por comas CSV, hay que pasar los siguientes parámetros:

days (opcional) 
número de días para hacer el corte de los días vencidos. Un valor positivo representa documentos vencidos y un valor negativo representa documentos por vencer. Al colocar esta opción se retornan todos los documentos con vencimiento mayor al valor suministrado.

Para realizar una consulta:

wget --user=jlopez --password=comic --no-check-certificate -qO- \
  "https://host/direct/items/contact-pending"

El resultado retorna los siguientes campos:

contactId 
el identificador único del contacto dentro de Nimbox-logo-small.png NiMbox.
contactDisplayName 
el nombre del contacto.
documentCount 
cantidad de documentos pendientes.
documentTotal 
monto total de los documentos pendientes (sin incluir ningún pago aplicado).
documentPending 
monto por cobrar de los documentos pendientes.
documentWeightedDays 
días promedio ponderados de los documentos pendientes.
contactPhones 
telefonos del contacto formateado como; tipo:numero y separados por el caracter ';'.

Un ejemplo de este resultado se vería así:

"12590","Organizacion Palo Alto, C.A.","7","503008.76000","376258.75000","332","work:0212 285 3348;mobile:04122345678"
"540","COMUNICACIONES SICA, C.A","1","484.96000","116.48000","6","mobile:04122345678"
"406","RUSTI ACCESORIOS CORONA, C.A.","1","4693.92000","4693.92000","1","home:0212-2345678"
"12594","DISTRIBUIDORA DE UÑAS L.N. 2008, C.A","2","7694.49000","1680.49000","0","home:02122853348;mobile:04122345678"
"30229","FONDO DE INVERSIONES COMERCIAL AVILA, C.A","1","468.83000","468.83000","48",""
"30675","VERA ROLDAN FERNANDO ANTONIO","1","890.40000","890.40000","41",""
"12652","Lior Cosmetics, C.A.","11","150734.90000","150734.90000","466","mobile:04142345678"
"12556","EBANO GRUPO MODA, C.A.","1","104.16000","104.16000","468","mobile:04162345678"
"1026","ADVENTURE EXTREME 4X4, C.A.","1","7618.24000","7618.24000","52",""
"31469","TRAVELUSA TOURS VIAJES Y TURISMO C.A","1","97110.72000","39110.72000","49","mobile:04124545555;mobile:04122345678"
"12634","LOYOLA SPORT CLUB","1","29691.23000","26981.23000","510","mobile:+584122345678"
"852","AUDIO CAR, C.A.","1","2222.08000","2222.08000","41","mobile:58-412-2345678"