{"_id":"56b0dfa64b05c50d001ceaba","__v":26,"parentDoc":null,"category":{"_id":"56b4b2faeed075230097d688","__v":0,"project":"56abd2434e4b730d009eb10a","version":"56abd2434e4b730d009eb10d","pages":[],"sync":{"url":"","isSync":false},"reference":true,"createdAt":"2016-02-05T14:34:34.496Z","from_sync":false,"order":2,"slug":"contactos","title":"Contactos"},"user":"56abd213d4432d1900eed227","version":{"_id":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","__v":18,"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"],"is_deprecated":false,"is_hidden":false,"is_beta":false,"is_stable":true,"codename":"","version_clean":"1.0.0","version":"1"},"project":"56abd2434e4b730d009eb10a","updates":[],"next":{"pages":[],"description":""},"createdAt":"2016-02-02T16:56:06.864Z","link_external":false,"link_url":"","githubsync":"","sync_unique":"","hidden":false,"api":{"results":{"codes":[]},"settings":"","auth":"required","params":[],"url":""},"isReference":true,"order":0,"body":"Los contactos en Alegra representan los clientes y proveedores a los cuales asocias facturas de venta, notas crédito, facturas de compra y demás movimientos. Para saber más sobre los contactos haz clic [aquí](http://ayuda.alegra.com/hc/es/sections/201296825-Contactos).\n\nUn contacto se puede clasificar en cliente, proveedor, los dos o ninguno. Esta clasificación es únicamente informativa, la aplicación permite asociar facturas de venta a contactos de cualquier tipo.\n\nUn contacto contiene los siguientes atributos:\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Nombre\",\n    \"h-1\": \"Tipo\",\n    \"h-2\": \"Descripción\",\n    \"0-0\": \"id\",\n    \"0-1\": \"Integer\",\n    \"0-2\": \"Identificador único que representa un contacto específico. La aplicación lo asigna automáticamente.\",\n    \"1-0\": \"name\",\n    \"1-1\": \"String\",\n    \"1-2\": \"Nombre del contacto.\",\n    \"2-0\": \"identification\",\n    \"2-1\": \"String\",\n    \"2-2\": \"Número de identificación del contacto. Ejemplos: cédula, RFC, RNC, número de pasaporte.\",\n    \"3-0\": \"email\",\n    \"3-1\": \"String\",\n    \"3-2\": \"Correo electrónico del contacto.\",\n    \"4-0\": \"phonePrimary\",\n    \"5-0\": \"phoneSecondary\",\n    \"4-2\": \"Número telefónico principal del contacto.\",\n    \"5-2\": \"Número telefónico secundario del contacto.\",\n    \"4-1\": \"String\",\n    \"5-1\": \"String\",\n    \"6-0\": \"fax\",\n    \"7-0\": \"mobile\",\n    \"6-2\": \"Fax del contacto.\",\n    \"7-2\": \"Número de célular/móvil.\",\n    \"6-1\": \"String\",\n    \"7-1\": \"String\",\n    \"8-0\": \"observations\",\n    \"9-0\": \"priceList\",\n    \"8-2\": \"Observaciones del contacto.\",\n    \"9-2\": \"Objecto PriceList que indica la lista de precios asociada al contacto.  Contiene los siguientes atributos:\\n* id: Identificador de la lista de precios.\\n* name: Nombre de la lista de precios.\",\n    \"9-1\": \"Object\",\n    \"8-1\": \"String\",\n    \"10-0\": \"seller\",\n    \"10-1\": \"Object\",\n    \"10-2\": \"Objeto Seller que indica el vendedor asociado al contacto.\\nContiene 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    \"11-0\": \"term\",\n    \"11-1\": \"Object\",\n    \"11-2\": \"Objecto Term que indica el término de pago del contacto, los cuales son los parámetros que definen cómo es el vencimiento de tus facturas de venta.\\nContienen los siguientes atributos:\\n* id: Identificador interno del término de pago.\\n* name: Nombre del término de pago. Ej: 8 días\\n* days: Días del término de pago. Ej: Para contactos que tienen  8 días de plazo para pagar, este atributo se configura en 8.\",\n    \"12-0\": \"address\",\n    \"12-1\": \"Objecto\",\n    \"12-2\": \"Contiene la información de la dirección del contacto.\\nPara versiones diferentes a Alegra México este objeto contiene los siguientes atributos:\\n* address : Indica la dirección del contacto.\\n* city: Ciudad del contacto.\\n\\nPara versión Alegra México:\\n* street: Indica la calle del contacto.\\n* exteriorNumber: Indica el número de exterior.\\n* interiorNumber: Indica el número de interior.\\n* colony: Indica la colonia del contacto.\\n* country: Indica el país del contacto.\\n* locality: Indica la localidad.\\n* municipality:  Indica el municipio.\\n* state : Indica el estado del contacto.\\n* zipCode: Indica el código postal del contacto.\",\n    \"h-3\": \"Ejemplo\",\n    \"0-3\": \"5\",\n    \"1-3\": \"Juan Pablo Mesa\",\n    \"2-3\": \"901.589.545-2\",\n    \"3-3\": \"micorreo:::at:::miempresa.com\",\n    \"4-3\": \"+(99)(999) 999-99-99\",\n    \"5-3\": \"(999) 999-99-99\",\n    \"6-3\": \"(999) 999-99-99\",\n    \"7-3\": \"333 33 33\",\n    \"8-3\": \"\",\n    \"9-3\": \"```\\n{\\n   \\\"id\\\" : 5,\\n    \\\"name\\\": \\\"Distribuidor\\\"\\n}\\n```\",\n    \"10-3\": \"```\\n{\\n\\\"id\\\" : \\\"12\\\",\\n\\\"name\\\" : \\\"Diana Giraldo\\\",\\n\\\"identification\\\" : \\\"12355598\\\",\\n\\\"observations\\\" : \\\"Vendedor del área del oriente\\\"\\n}\\n```\",\n    \"11-3\": \"```\\n{\\n\\\"id\\\" : 1,\\n\\\"name\\\" : \\\"8 días\\\",\\n\\\"days\\\" : 8\\n}\\n```\",\n    \"12-3\": \"Para versiones diferentes a Alegra México: \\n```\\n{\\n\\\"address\\\" : \\\"Calle principal #45\\\",\\n\\\"city\\\" : \\\"Barcelona\\\"\\n}\\n```\\n\\nPara versión Alegra México:\\n\\n```\\n{\\n\\\"street\\\" : \\\"Centenario\\\",\\n\\\"exteriorNumber\\\" : 95,\\n\\\"interiorNumber\\\" : \\\"\\\",\\n\\\"colony\\\" : \\\"Coyoacán\\\",\\n\\\"country\\\" : \\\"México\\\",\\n\\\"locality\\\" : \\\"\\\",\\n\\\"municipality\\\" : \\\"\\\",\\n\\\"state\\\" : \\\"D.F\\\",\\n\\\"zipCode\\\" : \\\"12345\\\"\\n}\\n```\",\n    \"13-0\": \"type\",\n    \"13-1\": \"Array\",\n    \"13-2\": \"Indica si el contacto es cliente, proveedor, los dos o ninguno. Las opciones posibles son 'client' si el contacto es cliente, 'provider' si el contacto es proveedor.\",\n    \"13-3\": \"['provider','client']\",\n    \"14-0\": \"internalContacts\",\n    \"14-1\": \"Array\",\n    \"14-2\": \"Array de objetos internalContact que indica los contactos internos asociados al contacto. Cada objeto contiene los siguientes atributos:\\n* id: Identificador interno  del contacto interno.\\n* name: Nombre del contacto interno.\\n* lastName: Apellido del contacto interno.\\n* email: Correo del contacto interno.\\n* phone: Teléfono del contacto interno.\\n* mobile: Célular/móvil del contacto interno.\\n* sendNotifications: Indica si se desee activar las notificaciones de vencimiento de factura. [Ver más](http://ayuda.alegra.com/hc/es/articles/205762059-Notificaciones-Vencimiento-de-factura).\",\n    \"14-3\": \"```\\n{\\n\\\"id\\\" : 1,\\n\\\"name\\\" : \\\"Andrea\\\",\\n\\\"lastName\\\" : \\\"Restrepo\\\",\\n\\\"email\\\" : \\\"prueba3@alegra.com\\\",\\n\\\"phone\\\" : \\\"999-99-99 ext 105\\\"\\n\\\"mobile\\\" : \\\"\\\",\\n\\\"sendNotifications\\\" : true               \\n}\\n```\"\n  },\n  \"cols\": 4,\n  \"rows\": 15\n}\n[/block]","excerpt":"Endpoint /contacts","slug":"contactos","type":"basic","title":"Descripción general"}

Descripción general

Endpoint /contacts

Los contactos en Alegra representan los clientes y proveedores a los cuales asocias facturas de venta, notas crédito, facturas de compra y demás movimientos. Para saber más sobre los contactos haz clic [aquí](http://ayuda.alegra.com/hc/es/sections/201296825-Contactos). Un contacto se puede clasificar en cliente, proveedor, los dos o ninguno. Esta clasificación es únicamente informativa, la aplicación permite asociar facturas de venta a contactos de cualquier tipo. Un contacto contiene los siguientes atributos: [block:parameters] { "data": { "h-0": "Nombre", "h-1": "Tipo", "h-2": "Descripción", "0-0": "id", "0-1": "Integer", "0-2": "Identificador único que representa un contacto específico. La aplicación lo asigna automáticamente.", "1-0": "name", "1-1": "String", "1-2": "Nombre del contacto.", "2-0": "identification", "2-1": "String", "2-2": "Número de identificación del contacto. Ejemplos: cédula, RFC, RNC, número de pasaporte.", "3-0": "email", "3-1": "String", "3-2": "Correo electrónico del contacto.", "4-0": "phonePrimary", "5-0": "phoneSecondary", "4-2": "Número telefónico principal del contacto.", "5-2": "Número telefónico secundario del contacto.", "4-1": "String", "5-1": "String", "6-0": "fax", "7-0": "mobile", "6-2": "Fax del contacto.", "7-2": "Número de célular/móvil.", "6-1": "String", "7-1": "String", "8-0": "observations", "9-0": "priceList", "8-2": "Observaciones del contacto.", "9-2": "Objecto PriceList que indica la lista de precios asociada al contacto. Contiene los siguientes atributos:\n* id: Identificador de la lista de precios.\n* name: Nombre de la lista de precios.", "9-1": "Object", "8-1": "String", "10-0": "seller", "10-1": "Object", "10-2": "Objeto Seller que indica el vendedor asociado al contacto.\nContiene 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.", "11-0": "term", "11-1": "Object", "11-2": "Objecto Term que indica el término de pago del contacto, los cuales son los parámetros que definen cómo es el vencimiento de tus facturas de venta.\nContienen los siguientes atributos:\n* id: Identificador interno del término de pago.\n* name: Nombre del término de pago. Ej: 8 días\n* days: Días del término de pago. Ej: Para contactos que tienen 8 días de plazo para pagar, este atributo se configura en 8.", "12-0": "address", "12-1": "Objecto", "12-2": "Contiene la información de la dirección del contacto.\nPara versiones diferentes a Alegra México este objeto contiene los siguientes atributos:\n* address : Indica la dirección del contacto.\n* city: Ciudad del contacto.\n\nPara versión Alegra México:\n* street: Indica la calle del contacto.\n* exteriorNumber: Indica el número de exterior.\n* interiorNumber: Indica el número de interior.\n* colony: Indica la colonia del contacto.\n* country: Indica el país del contacto.\n* locality: Indica la localidad.\n* municipality: Indica el municipio.\n* state : Indica el estado del contacto.\n* zipCode: Indica el código postal del contacto.", "h-3": "Ejemplo", "0-3": "5", "1-3": "Juan Pablo Mesa", "2-3": "901.589.545-2", "3-3": "micorreo@miempresa.com", "4-3": "+(99)(999) 999-99-99", "5-3": "(999) 999-99-99", "6-3": "(999) 999-99-99", "7-3": "333 33 33", "8-3": "", "9-3": "```\n{\n \"id\" : 5,\n \"name\": \"Distribuidor\"\n}\n```", "10-3": "```\n{\n\"id\" : \"12\",\n\"name\" : \"Diana Giraldo\",\n\"identification\" : \"12355598\",\n\"observations\" : \"Vendedor del área del oriente\"\n}\n```", "11-3": "```\n{\n\"id\" : 1,\n\"name\" : \"8 días\",\n\"days\" : 8\n}\n```", "12-3": "Para versiones diferentes a Alegra México: \n```\n{\n\"address\" : \"Calle principal #45\",\n\"city\" : \"Barcelona\"\n}\n```\n\nPara versión Alegra México:\n\n```\n{\n\"street\" : \"Centenario\",\n\"exteriorNumber\" : 95,\n\"interiorNumber\" : \"\",\n\"colony\" : \"Coyoacán\",\n\"country\" : \"México\",\n\"locality\" : \"\",\n\"municipality\" : \"\",\n\"state\" : \"D.F\",\n\"zipCode\" : \"12345\"\n}\n```", "13-0": "type", "13-1": "Array", "13-2": "Indica si el contacto es cliente, proveedor, los dos o ninguno. Las opciones posibles son 'client' si el contacto es cliente, 'provider' si el contacto es proveedor.", "13-3": "['provider','client']", "14-0": "internalContacts", "14-1": "Array", "14-2": "Array de objetos internalContact que indica los contactos internos asociados al contacto. Cada objeto contiene los siguientes atributos:\n* id: Identificador interno del contacto interno.\n* name: Nombre del contacto interno.\n* lastName: Apellido del contacto interno.\n* email: Correo del contacto interno.\n* phone: Teléfono del contacto interno.\n* mobile: Célular/móvil del contacto interno.\n* sendNotifications: Indica si se desee activar las notificaciones de vencimiento de factura. [Ver más](http://ayuda.alegra.com/hc/es/articles/205762059-Notificaciones-Vencimiento-de-factura).", "14-3": "```\n{\n\"id\" : 1,\n\"name\" : \"Andrea\",\n\"lastName\" : \"Restrepo\",\n\"email\" : \"prueba3@alegra.com\",\n\"phone\" : \"999-99-99 ext 105\"\n\"mobile\" : \"\",\n\"sendNotifications\" : true \n}\n```" }, "cols": 4, "rows": 15 } [/block]