{"_id":"5d76e23cb2c90103f600ba9b","project":"56abd2434e4b730d009eb10a","version":{"_id":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","__v":30,"createdAt":"2016-01-29T20:57:39.712Z","releaseDate":"2016-01-29T20:57:39.712Z","categories":["56abd2444e4b730d009eb10e","56abd4c8f25f160d00e17f81","56abd72ff25f160d00e17f84","56b3b8ea9f97020d0012d936","56b3b91ac25dea2b00b0cac9","56b4b2faeed075230097d688","56b4b32deed075230097d689","56b4b37327d9c00d005d6bc4","56b4b3bf3d5f130d00dad120","56b4b3d9eed075230097d68a","56b4b3eb7bccae0d00e9a12e","56b4b4085997532100bc6b61","56fbce6e2885e80e006c855f","5739ed9aad40e23200f674b6","573dd672b3f88f0e00dcae1c","58ad0922e570c62500512a82","58ad092b55018f1900218fda","58e412a5aa544d1b0005f7da","59e62c2a3ccab100263e800a","59e63126b4f8b0002edbe92c","5b5bbc98eaf71700031c2fda","5bedb529a56934002ee522b9","5c3e39454d3006001420f73e","5c4f5c0e1555130014796daa","5c6ac741acb04f003f927fa7","5c7e9c7c412d4c003f750162","5d055915910ab30020e5bc06","5d76e2018e0ce7006c82dbe1","5d9ca92eac34370012872d08","5d9f8149103b9f006c1421e0"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1"},"category":{"_id":"5d76e2018e0ce7006c82dbe1","project":"56abd2434e4b730d009eb10a","version":"56abd2434e4b730d009eb10d","__v":0,"sync":{"url":"","isSync":false},"reference":false,"createdAt":"2019-09-09T23:36:33.957Z","from_sync":false,"order":21,"slug":"remisiones","title":"Remisiones"},"user":"56abd213d4432d1900eed227","__v":0,"parentDoc":null,"metadata":{"title":"","description":"","image":[]},"updates":[],"next":{"pages":[],"description":""},"createdAt":"2019-09-09T23:37:32.528Z","link_external":false,"link_url":"","sync_unique":"","hidden":false,"api":{"examples":{"codes":[]},"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":false,"order":0,"body":"Las remisiones son un documento mercantil interno de las compañías, que sirve como prueba documental en todo acto de compra venta comercial, cuya función es dejar constancia, a través de la firma del receptor, de la recepción de un pedido de mercadería.\n\nLas remisiones en Alegra deben estar asociadas a un contacto y deben contener mínimo un producto o servicio.\n\nUna remisión contiene los siguientes atributos:\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Nombre\",\n    \"h-1\": \"Tipo\",\n    \"h-2\": \"Descripción\",\n    \"h-3\": \"Ejemplo\",\n    \"0-0\": \"id\",\n    \"0-1\": \"Integer\",\n    \"0-2\": \"Identificador único que representa una remisión específica. La aplicación lo asigna automáticamente.\",\n    \"0-3\": \"10\",\n    \"1-0\": \"date\",\n    \"1-1\": \"String.  Formato yyyy-MM-dd\",\n    \"1-2\": \"Fecha de la remisión.\",\n    \"1-3\": \"2019-09-11\",\n    \"2-0\": \"dueDate\",\n    \"2-1\": \"String.  Formato yyyy-MM-dd\",\n    \"2-2\": \"Fecha de vencimiento de la remisión.\",\n    \"2-3\": \"2019-10-11\",\n    \"3-0\": \"number\",\n    \"3-1\": \"String\",\n    \"3-2\": \"Número de la remisión. Lo asigna automáticamente la aplicación según la configuración de la empresa.\",\n    \"3-3\": \"10\",\n    \"4-0\": \"observations\",\n    \"4-1\": \"String\",\n    \"4-2\": \"Observaciones de la remisión. No visibles en el documento impreso o PDF.\",\n    \"4-3\": \"Se han modificado los precios de los items de la remisión.\",\n    \"5-0\": \"anotation\",\n    \"5-1\": \"String\",\n    \"5-2\": \"Notas de la remisión, visibles en el documento impreso o PDF.\",\n    \"5-3\": \"La remisión tiene validez por dos meses después de emitida.\",\n    \"6-0\": \"client\",\n    \"6-1\": \"Object\",\n    \"6-2\": \"Objeto que contiene la *información* del cliente asociado a la remisión.\",\n    \"6-3\": \"```\\n{\\n\\\"id\\\": 1,\\n\\\"name\\\": \\\"Coorporación Alegrate\\\",                        \\\"identification\\\": \\\"159.549.847\\\",\\n\\\"email\\\": \\\"prueba:::at:::alegra.com\\\",                      \\\"phonePrimary\\\": \\\"999-99-99\\\",\\n\\\"phoneSecondary\\\": \\\"\\\",\\n\\\"fax\\\": \\\"\\\",\\n\\\"mobile\\\": \\\"(333) 555-55-55\\\",\\n\\\"address\\\" : {\\n   \\\"address\\\" : \\\"Calle principal #45\\\",\\n    \\\"city\\\" : \\\"Barcelona\\\"\\n  }\\n}\\n```\",\n    \"7-0\": \"total\",\n    \"7-1\": \"Double\",\n    \"7-2\": \"Total de la remisión. Se debe tener en cuenta que el total de la remisión es calculado según la precisión decimal que tenga configurada la empresa al momento de crearla.\",\n    \"7-3\": \"12500.45\",\n    \"8-0\": \"items\",\n    \"8-1\": \"Array\",\n    \"8-2\": \"Array de objetos Item, que contiene los productos o servicios asociados a la remisión.\\nCada objeto contiene los siguientes atributos:\\n* id: Identificador del producto o servicio vendido. \\n* name: Nombre del producto o servicio.\\n* description: Descripción del producto o servicio.\\n* reference: Referencia del producto o servicio\\n* discount: Porcentaje de descuento aplicado al producto.\\n* tax: Array de objetos tax que indican los impuestos aplicados al producto o servicio al momento de la venta.\\n* price: Precio de venta del producto o servicio.\\n* quantity: Cantidad vendida del producto o servicio.\\n* total: Total del producto (no incluye impuestos).\",\n    \"8-3\": \"```\\n[\\n{\\n\\\"id\\\": 1,\\n\\\"name\\\": \\\"Billetera\\\",\\n\\\"description\\\": \\\"Billetera de cuero negro\\\",\\n\\\"reference\\\": \\\"REF-005\\\",\\n\\\"discount\\\" : 10,\\n\\\"tax\\\" : [\\n{\\n\\\"id\\\" : 6,\\n\\\"name\\\" : \\\"IVA\\\",\\n\\\"percentage\\\" : 16,\\n\\\"description\\\" : \\\"Impuesto de valor agregado\\\",\\n\\\"type\\\": \\\"IVA\\\",\\n\\\"status\\\" : \\\"active\\\"\\n}\\n],\\n\\\"price\\\" : 80,\\n\\\"quantity\\\" : 5\\n},\\n\\\"total\\\" : 360\\n]\\n```\",\n    \"9-0\": \"seller\",\n    \"9-1\": \"Object\",\n    \"9-2\": \"Objeto que indica el vendedor asociado a la remisión. Éste contiene los siguientes atributos:\\n* id: Identificador del vendedor.\\n* name : Nombre del vendedor.\\n* identification: Identificación (Nit, RFC, cédula, etc) del vendedor.\\n* observations: Observaciones del vendedor.\",\n    \"9-3\": \"```\\n{\\n\\\"id\\\" : \\\"12\\\",\\n\\\"name\\\" : \\\"Diana Giraldo\\\",\\n\\\"identification\\\" : \\\"520.526.21\\\",\\n\\\"observations\\\" : \\\"Líder de Ventas\\\"\\n}\\n```\",\n    \"10-0\": \"priceList\",\n    \"10-1\": \"Object\",\n    \"10-2\": \"Objeto PriceList que indica la lista de precios asociada a la reisión. Ésta contiene los siguientes atributos:\\n* id: Identificador de la lista de precios.\\n* name: Nombre de la lista de precios.\",\n    \"10-3\": \"```\\n{\\n\\\"id\\\" : 5,\\n\\\"name\\\" : \\\"Distribuidor\\\"\\n}\\n```\",\n    \"11-0\": \"currency\",\n    \"11-1\": \"Object\",\n    \"11-2\": \"Objeto que incluye la información de la moneda asociada a la remisión.\\n** Solo se incluye si la compañía tiene activo multimoneda y la cotización está en una moneda diferente de la principal de la cuenta.\\n**\\nEste objeto contiene:\\n* code : Código ISO de la moneda asociada a la empresa.\\n* exchangeRate: Tasa de cambio.\",\n    \"11-3\": \"```\\n{\\n\\\"code\\\" : \\\"USD\\\",\\n\\\"symbol\\\" : \\\"$\\\",\\n\\\"exchangeRate\\\" : 3000\\n}\\n```\",\n    \"12-0\": \"documentName\",\n    \"12-1\": \"String\",\n    \"12-2\": \"Nombre del tipo de documento, las opciones disponibles son Remisión y Orden de servicio.\",\n    \"12-3\": \"remission, serviceOrder\",\n    \"13-0\": \"status\",\n    \"13-1\": \"String\",\n    \"13-2\": \"Estado actual de la remisión.\",\n    \"13-3\": \"open, void, closed\",\n    \"14-0\": \"warehouse\",\n    \"14-1\": \"Object\",\n    \"14-2\": \"Objeto de la bodega asociada con la remisión.\",\n    \"14-3\": \"```\\n{\\n    \\\"id\\\": \\\"1\\\",\\n    \\\"name\\\": \\\"Principal\\\"\\n}\\n```\"\n  },\n  \"cols\": 4,\n  \"rows\": 15\n}\n[/block]","excerpt":"Endpoint /remissions","slug":"remisiones","type":"basic","title":"Descripción general"}

Descripción general

Endpoint /remissions

Las remisiones son un documento mercantil interno de las compañías, que sirve como prueba documental en todo acto de compra venta comercial, cuya función es dejar constancia, a través de la firma del receptor, de la recepción de un pedido de mercadería. Las remisiones en Alegra deben estar asociadas a un contacto y deben contener mínimo un producto o servicio. Una remisión contiene los siguientes atributos: [block:parameters] { "data": { "h-0": "Nombre", "h-1": "Tipo", "h-2": "Descripción", "h-3": "Ejemplo", "0-0": "id", "0-1": "Integer", "0-2": "Identificador único que representa una remisión específica. La aplicación lo asigna automáticamente.", "0-3": "10", "1-0": "date", "1-1": "String. Formato yyyy-MM-dd", "1-2": "Fecha de la remisión.", "1-3": "2019-09-11", "2-0": "dueDate", "2-1": "String. Formato yyyy-MM-dd", "2-2": "Fecha de vencimiento de la remisión.", "2-3": "2019-10-11", "3-0": "number", "3-1": "String", "3-2": "Número de la remisión. Lo asigna automáticamente la aplicación según la configuración de la empresa.", "3-3": "10", "4-0": "observations", "4-1": "String", "4-2": "Observaciones de la remisión. No visibles en el documento impreso o PDF.", "4-3": "Se han modificado los precios de los items de la remisión.", "5-0": "anotation", "5-1": "String", "5-2": "Notas de la remisión, visibles en el documento impreso o PDF.", "5-3": "La remisión tiene validez por dos meses después de emitida.", "6-0": "client", "6-1": "Object", "6-2": "Objeto que contiene la *información* del cliente asociado a la remisión.", "6-3": "```\n{\n\"id\": 1,\n\"name\": \"Coorporación Alegrate\", \"identification\": \"159.549.847\",\n\"email\": \"prueba@alegra.com\", \"phonePrimary\": \"999-99-99\",\n\"phoneSecondary\": \"\",\n\"fax\": \"\",\n\"mobile\": \"(333) 555-55-55\",\n\"address\" : {\n \"address\" : \"Calle principal #45\",\n \"city\" : \"Barcelona\"\n }\n}\n```", "7-0": "total", "7-1": "Double", "7-2": "Total de la remisión. Se debe tener en cuenta que el total de la remisión es calculado según la precisión decimal que tenga configurada la empresa al momento de crearla.", "7-3": "12500.45", "8-0": "items", "8-1": "Array", "8-2": "Array de objetos Item, que contiene los productos o servicios asociados a la remisión.\nCada objeto contiene los siguientes atributos:\n* id: Identificador del producto o servicio vendido. \n* name: Nombre del producto o servicio.\n* description: Descripción del producto o servicio.\n* reference: Referencia del producto o servicio\n* discount: Porcentaje de descuento aplicado al producto.\n* tax: Array de objetos tax que indican los impuestos aplicados al producto o servicio al momento de la venta.\n* price: Precio de venta del producto o servicio.\n* quantity: Cantidad vendida del producto o servicio.\n* total: Total del producto (no incluye impuestos).", "8-3": "```\n[\n{\n\"id\": 1,\n\"name\": \"Billetera\",\n\"description\": \"Billetera de cuero negro\",\n\"reference\": \"REF-005\",\n\"discount\" : 10,\n\"tax\" : [\n{\n\"id\" : 6,\n\"name\" : \"IVA\",\n\"percentage\" : 16,\n\"description\" : \"Impuesto de valor agregado\",\n\"type\": \"IVA\",\n\"status\" : \"active\"\n}\n],\n\"price\" : 80,\n\"quantity\" : 5\n},\n\"total\" : 360\n]\n```", "9-0": "seller", "9-1": "Object", "9-2": "Objeto que indica el vendedor asociado a la remisión. Éste contiene los siguientes atributos:\n* id: Identificador del vendedor.\n* name : Nombre del vendedor.\n* identification: Identificación (Nit, RFC, cédula, etc) del vendedor.\n* observations: Observaciones del vendedor.", "9-3": "```\n{\n\"id\" : \"12\",\n\"name\" : \"Diana Giraldo\",\n\"identification\" : \"520.526.21\",\n\"observations\" : \"Líder de Ventas\"\n}\n```", "10-0": "priceList", "10-1": "Object", "10-2": "Objeto PriceList que indica la lista de precios asociada a la reisión. Ésta contiene los siguientes atributos:\n* id: Identificador de la lista de precios.\n* name: Nombre de la lista de precios.", "10-3": "```\n{\n\"id\" : 5,\n\"name\" : \"Distribuidor\"\n}\n```", "11-0": "currency", "11-1": "Object", "11-2": "Objeto que incluye la información de la moneda asociada a la remisión.\n** Solo se incluye si la compañía tiene activo multimoneda y la cotización está en una moneda diferente de la principal de la cuenta.\n**\nEste objeto contiene:\n* code : Código ISO de la moneda asociada a la empresa.\n* exchangeRate: Tasa de cambio.", "11-3": "```\n{\n\"code\" : \"USD\",\n\"symbol\" : \"$\",\n\"exchangeRate\" : 3000\n}\n```", "12-0": "documentName", "12-1": "String", "12-2": "Nombre del tipo de documento, las opciones disponibles son Remisión y Orden de servicio.", "12-3": "remission, serviceOrder", "13-0": "status", "13-1": "String", "13-2": "Estado actual de la remisión.", "13-3": "open, void, closed", "14-0": "warehouse", "14-1": "Object", "14-2": "Objeto de la bodega asociada con la remisión.", "14-3": "```\n{\n \"id\": \"1\",\n \"name\": \"Principal\"\n}\n```" }, "cols": 4, "rows": 15 } [/block]