Download the PHP package millancore/alegra without Composer

**Importante!!** Este SDK solo cuenta con metodos para administrar **Inventario** a traves de la API de Alegra, si usted necesita usar otros endpoints, este SDK fue creado modularmente lo que le permitira usarlo como marco de trabajo facilitandole la integracion. ## Alegra SDK Este es un SDK para para la API de [alegra.com](https://alegra.com ) que busca simplificar la integracion con proyectos en PHP. ## Instalacion **PHP 7.2 o superior** ## Configuracion #### Logger (Opcional) Es posible que se desee tener logs de la interacion con la API, para ello puede setear un Logger que cumpla con PSR-3. (Monolog, Laravel, Symfony etc) #### Eventos (Opcional) Los procesos mas criticos dentro de este SDK [Request, Error, Response] lanzan eventos, usted puede agregar un Listener para estos eventos de una manera sencilla permitiendole tomar deciciones en cada caso. (notificaciones, stats, error tracking etc.) Para crear un clase Listener solo debe implementar `Alegra\Contract\ListenerInterface` y agregar el listener a la instancia de Alegra. Cada evento despachado cuenta con dos metodos pricipales para acceder al contenido del evento `$event->getName()` y `$event->getParams()`. ## Uso Alegra cuenta con una variedad de endpoints, lo mas probable es que necesite hacer uso de estos desde diferentes puntos, en este SDK hemos pensando en facilitar esta tarea implementando **Facades** para cada grupo. Asi que para traer un producto por Id es tan simple como esto. Aqui una lista de los Facades disponibles, cada uno cuenta con la lista de metodos asi como ejemplos sencillos de uso. - Productos y Servicios [Item](https://github.com/millancore/alegra/blob/master/examples/Item.md) - Categorias [Category](https://github.com/millancore/alegra/blob/master/examples/Category.md) - Bodegas [Warehouse](https://github.com/millancore/alegra/blob/master/examples/Warehouse.md) - Lista de Precios [PriceList](https://github.com/millancore/alegra/blob/master/examples/PriceList.md) ### Entidades Cuando hacemos llamadas a la API de Alegra a traves de este SDK obtenemos entidades, podemos acceder a las propiedades de cada entidad de la siguiente manera. Siguendo el mismo esquema de nombres que esta presente en la [documentacion](https://developer.alegra.com/docs/productos-o-servicios) de la API. Las entidades tambien cuenta con metodos que nos permiten manejar sus datos de diferentes maneras. Array Json ### Colecciones Algunas propiedades del las entidades son colecciones de otras, las colecciones son objetos iterables que nos permiten recorrerlos para hacer uso de las entidades almacenadas. Iterar Contar Array Json ## Manejo de Excepciones Este SDK maneja una serie de excepciones segun diferentes posibles casos de error o validacion, sin embargo todas extienden de `Alegra\Exception\AlegraException` lo que simplifica el manejo de excepciones.