{"_id":"56af82fd5b1f01170014dbd6","__v":69,"body":"El API de Alegra es un servicio que te permite acceder a tu cuenta para mantener tu información actualizada, conectar aplicaciones externas y tener acceso instantáneo a tus datos. \n\nAlgunas aplicaciones que puedes construir con nuestra API son:\n\n * Sincronizar de manera automática tus contactos con Alegra y otra aplicación externa que utilices.\n * Crear automáticamente facturas en la aplicación a partir de pedidos de tu página web.\n * Sincronizar tus productos o servicios con Alegra.\n\nActualmente nuestra API puedes\n[block:parameters]\n{\n \"data\": {\n \"h-0\": \"Recurso\",\n \"h-1\": \"Endpoint\",\n \"h-2\": \"Descripción\",\n \"0-0\": \"Productos o servicios\",\n \"0-1\": \"/items\",\n \"0-2\": \"Consultar uno o todos los productos/servicios registrados en la aplicación. También puedes crear un producto nuevo.\",\n \"1-0\": \"Contactos\",\n \"2-0\": \"Facturas de venta\",\n \"3-0\": \"Numeración de factura\",\n \"4-0\": \"Impuestos\",\n \"5-0\": \"Cuentas de banco\",\n \"6-0\": \"Empresa\",\n \"7-0\": \"Pagos\",\n \"8-0\": \"Categorías\",\n \"1-2\": \"Consultar uno o todos los contactos (clientes/proveedores) registrados. También puedes crear un contacto nuevo.\",\n \"2-2\": \"Consultar una o todas las facturas de venta, crear una nueva o enviar una factura por correo.\",\n \"3-2\": \"Permite consultar las numeraciones para facturación que tiene configurada la empresa.\",\n \"4-2\": \"Permite consultar los impuestos de la compañía.\",\n \"5-2\": \"Permite consultar las cuentas de banco que tiene registrada la compañía en la aplicación.\",\n \"6-2\": \"Indica la información de la empresa como el nombre, dirección, régimen, entre otros.\",\n \"7-2\": \"Permite consultar los pagos que se tienen registrados en la aplicación. También se puede realizar pagos a facturas de venta, facturas de compra o categorías\",\n \"8-2\": \"Permite consultar las categorías configuradas en la aplicación.\",\n \"1-1\": \"/contacts\",\n \"2-1\": \"/invoices\",\n \"3-1\": \"/number-templates\",\n \"4-1\": \"/taxes\",\n \"5-1\": \"/bank-accounts\",\n \"6-1\": \"/company\",\n \"7-1\": \"/payments\",\n \"8-1\": \"/categories\",\n \"9-0\": \"Ajustes de categorías\",\n \"9-1\": \"/journals\",\n \"9-2\": \"Permite consultar uno o todos los ajustes de categorías registrados en la aplicación, crear uno nuevo, editarlos y eliminarlos.\",\n \"10-0\": \"Monedas\",\n \"10-1\": \"/currencies\",\n \"10-2\": \"Permite consultar una o todas las monedas asociadas a una cuenta.\"\n },\n \"cols\": 3,\n \"rows\": 11\n}\n[/block]\n\nNuestra API está basada en principios REST que harán más fácil tu conexión y desarrollo; métodos HTTP (GET y POST) son utilizados para acceder a los recursos. El sistema procesa el request y retorna un código de respuesta en un formato de fácil compresión.\n\n###Ejemplos\n[block:code]\n{\n \"codes\": [\n {\n \"code\": \"{\\n \\\"id\\\": 1,\\n \\\"name\\\": \\\"Billetera\\\",\\n \\\"description\\\": \\\"Billetera de cuero negro\\\",\\n \\\"reference\\\": \\\"REF-005\\\",\\n \\\"inventory\\\": {\\n \\\"unit\\\" : \\\"piece\\\",\\n \\\"availableQuantity\\\" : 150,\\n \\\"unitCost\\\" : 560,\\n \\\"initialQuantity\\\" : 320\\n },\\n \\\"tax\\\" : [\\n {\\n \\\"id\\\" : 6,\\n \\\"name\\\" : \\\"IVA\\\",\\n \\\"percentage\\\" : 16,\\n \\\"description\\\" : \\\"Impuesto de valor agregado\\\"\\n }\\n ],\\n \\\"category\\\" : {\\n \\\"id\\\": 54,\\n \\\"name\\\" : \\\"Ventas\\\"\\n },\\n \\\"price\\\" : [\\n {\\n \\\"idPriceList\\\" : 1,\\n \\\"name\\\" : \\\"General\\\",\\n \\\"price\\\" : 1200\\n },\\n {\\n \\\"idPriceList\\\" : 2,\\n \\\"name\\\" : \\\"Distribuidor\\\",\\n \\\"price\\\" : 1050\\n }\\n ]\\n \\n}\",\n \"language\": \"json\",\n \"name\": \"Respuesta exitosa (Código HTTP 200) \"\n },\n {\n \"code\": \"{\\n\\\"code\\\" : \\\"901\\\",\\n\\\"message\\\" : \\\"Esta acción no está permitida para el usuario actual.\\\"\\n}\",\n \"language\": \"json\",\n \"name\": \"Respuesta error (Código HTTP 403)\"\n }\n ]\n}\n[/block]\n**El formato de transferencia de datos soportado por la aplicación es JSON. Todas las respuestas se envían en formato JSON y así espera recibirlos.** \n[block:callout]\n{\n \"type\": \"warning\",\n \"title\": \"Toda la comunicación con el API debe hacerse utilizando https://\"\n}\n[/block]\n## Códigos de respuesta HTTP\n\nEl API puede retornar alguno de los siguientes códigos HTTP:\n[block:parameters]\n{\n \"data\": {\n \"h-0\": \"Código\",\n \"h-1\": \"Descripción\",\n \"0-0\": \"400\",\n \"0-1\": \"El request está mal formado. La información para crear el recurso no existe o es inválida.\",\n \"1-0\": \"401\",\n \"1-1\": \"Error en autenticación. La autenticación fallo o no se encontró la información para autenticar el request.\",\n \"3-0\": \"403\",\n \"3-1\": \"El usuario no tiene permisos para realizar la acción.\",\n \"4-0\": \"404\",\n \"5-0\": \"405\",\n \"6-0\": \"201\",\n \"7-0\": \"200\",\n \"8-0\": \"500\",\n \"4-1\": \"No se encontró en la aplicación el recurso que se está buscando. También se retorna cuando la cuenta se encuentra suspendida.\",\n \"5-1\": \"Operación no permitida. Ocurre cuando el método del request es inválido para el endpoint requerido.\",\n \"6-1\": \"El recurso se creó exitosamente.\",\n \"7-1\": \"Todo funcionó correctamente.\",\n \"8-1\": \"Ocurrió un error en la aplicación.\",\n \"2-0\": \"402\",\n \"2-1\": \"Pago requerido. La acción no se pudo realizar exitosamente ya que la cuenta se encuentra suspendida o el plan actual de la compañía no permite realizar la acción.\",\n \"9-0\": \"503\",\n \"9-1\": \"Servicio no disponible. Eje: Modo mantenimiento de la aplicación.\"\n },\n \"cols\": 2,\n \"rows\": 10\n}\n[/block]\n##Pruebas en vivo\nEn nuestra documentación encontrarás un explorador de API que te permite realizar requests a tu cuenta y descubrir cómo funciona.\n[block:callout]\n{\n \"type\": \"warning\",\n \"title\": \"Debes tener en cuenta que los request que realices pueden modificar la información de tu cuenta.\",\n \"body\": \"Para utilizar el API explorer debes utilizar tu correo y [token de acceso](/docs/limite-request).\"\n}\n[/block]\n## Lecturas recomendadas\nAntes de comenzar te recomendamos los siguientes documentos que pueden ser de ayuda:\n\n[Autenticación](doc:autenticacion) \n[Limite request](doc:limite-request)","createdAt":"2016-02-01T16:08:29.126Z","link_external":false,"type":"basic","category":"56abd2444e4b730d009eb10e","link_url":"","excerpt":"Esta página te ayudará a comenzar con el API de Alegra","hidden":false,"project":"56abd2434e4b730d009eb10a","slug":"empiezar-con-api-alegra","title":"Información general","user":"56abd213d4432d1900eed227","updates":["609c3f33cb84bd00ece9fdfe","609c3f612cb88f038a9922ce","60e8819726eb3c0044b2952c","61e9befe3ac324015b30075f"],"version":"56abd2434e4b730d009eb10d","api":{"url":"","auth":"required","params":[],"results":{"codes":[]},"settings":""},"githubsync":"","isReference":false,"order":0,"parentDoc":null,"sync_unique":"","next":{"description":"","pages":[]},"metadata":{"title":"","description":"","image":[]},"childrenPages":[]}
Información general
Esta página te ayudará a comenzar con el API de Alegra