Resumen

Komet permite integrarse con sistemas externos como sistemas de finca o de agencias de carga. Algunos ejemplos de sistemas con los cuales Komet tiene integración son Unosof, Cargo Master, Quickbooks, entre otros. Sin embargo, a través de su API, Komet ofrece la posibilidad de conectarse con cualquier sistema externo, siempre y cuando el sistema externo también tenga esta posibilidad. 

¿Qué es el API de Komet?

Es un conjunto de tareas y funciones para acceder a cierta información de Komet desde otro sistema usando peticiones HTTPS. Hay un solo punto de entrada al API de Komet:

https://api.kometsales.com/api/method.action

Todas las solicitudes deben enviarse usando SSL. Es necesario enviar un token de autenticación para cada solicitud. Por favor use el método de acceso para obtener un token y guárdelo en su aplicación. De allí en adelante podrá usar el mismo token para las demas peticiones. 

Por favor tenga en cuenta que el API tiene un límite de 1000 solicitudes diarias por usuario, y dependiendo del número de usuarios que tenga su plan esto puede variar. Por ejemplo, si su compañía está pagando por 5 usuarios en Komet, su sistema externo podrá realizar peticiones al API hasta 5000 veces al día.

 

¿Cómo generar un Token?

Ir a Config>>Ajustes.

Hacer clic en Tokens.

Si es necesario crear un nuevo token, hacer clic en el botón Nuevo Token.

Ingresar una descripción (por ejemplo, cargar de guías) y seleccionar el tipo de token company (compañía), customer (cliente) o vendor (proveedor).

De la lista, seleccione el método del API que se requiera, por ejemplo purchase.order.item.awb.add (agregar producto a un AWB).

Hacer clic en el botón Generar. El sistema creará un token compuesto de números y letras, este es necesario para usar el API.

Hacer clic en Guardar.

Si el token debe editarse, ir a la columna de Acciones, hacer click en Editar y guardar.

¿Cúales métodos del API están disponibles para los proveedores?
MétodoUtilidad
box.code.change Permite cambiar uno o más códigos de caja.
boxtype.list Este método retorna una lista de tipos de caja ordenados por el código del tipo de caja.
carrier.listEste método retorna una lista de transportadores ordenados por el nombre del transportador.
company.location.list Este método retorna una lista de sedes de la compañía asociadas al cliente.
customer.list Este método retorna una lista de clientes organizados por nombre de cliente.
customer.shipto.listPermite obtener la lista de direcciones de envío asociadas a un cliente dado.
inventory.listEste método permite obtener una lista con el inventario disponible actual.
prebook.createPermite agregar Preventas al sistema.
prebook.details.listRetorna una lista de Preventas con sus correspondientes detalles.
prebook.item.deletePermite eliminar un producto de una Preventa existente en Komet Sales.
product.listPermite obtener una lista de productos ordenados por su descripción.
purchase.order.createPermite crear Órdenes de Compra desde Preventas.
purchase.order.item.awb.addPermite agregar líneas de producto de una Orden de Compra a una guía (AWB).
purchase.order.item.deletePermite eliminar productos de una Orden de Compra existente en Komet Sales.
purchase.order.listEste método retorna una lista de Órdenes de Compra con sus correspondientes detalles.
purchase.order.mixed.createPermite crear Órdenes de Compra con producto surtido desde artículos de Preventas en unidades.

Importante

  • Lo que esté en negrilla es requerido.
  • Los valores de fechas y horas tienen el formato YYYY-MM-DD HH:MM:SS.
  • Todos los valores se retornan en la zona horaria UTC.
  • Los valores boleanos son 1 (verdadero) o 0 (falso).

|