{"_id":"56b0dfa64b05c50d001ceaba","__v":27,"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":20,"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"],"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    \"4-0\": \"email\",\n    \"4-1\": \"String\",\n    \"4-2\": \"Correo electrónico del contacto.\",\n    \"5-0\": \"phonePrimary\",\n    \"6-0\": \"phoneSecondary\",\n    \"5-2\": \"Número telefónico principal del contacto.\",\n    \"6-2\": \"Número telefónico secundario del contacto.\",\n    \"5-1\": \"String\",\n    \"6-1\": \"String\",\n    \"7-0\": \"fax\",\n    \"8-0\": \"mobile\",\n    \"7-2\": \"Fax del contacto.\",\n    \"8-2\": \"Número de célular/móvil.\",\n    \"7-1\": \"String\",\n    \"8-1\": \"String\",\n    \"9-0\": \"observations\",\n    \"10-0\": \"priceList\",\n    \"9-2\": \"Observaciones del contacto.\",\n    \"10-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    \"10-1\": \"Object\",\n    \"9-1\": \"String\",\n    \"11-0\": \"seller\",\n    \"11-1\": \"Object\",\n    \"11-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    \"12-0\": \"term\",\n    \"12-1\": \"Object\",\n    \"12-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    \"13-0\": \"address\",\n    \"13-1\": \"Object\",\n    \"13-2\": \"Objeto que contiene la información de la dirección del contacto.\\n\\nContiene los siguientes atributos:\\n* address : Indica la dirección del contacto.\\n* city: Ciudad del contacto.\",\n    \"h-3\": \"Ejemplo\",\n    \"0-3\": \"5\",\n    \"1-3\": \"Juan Pablo Mesa\",\n    \"2-3\": \"901.589.545-2\",\n    \"4-3\": \"micorreo:::at:::miempresa.com\",\n    \"5-3\": \"+(99)(999) 999-99-99\",\n    \"6-3\": \"(999) 999-99-99\",\n    \"7-3\": \"(999) 999-99-99\",\n    \"8-3\": \"333 33 33\",\n    \"9-3\": \"\",\n    \"10-3\": \"```\\n{\\n   \\\"id\\\" : 5,\\n    \\\"name\\\": \\\"Distribuidor\\\"\\n}\\n```\",\n    \"11-3\": \"```\\n{\\n\\\"id\\\" : \\\"12\\\",\\n\\\"name\\\" : \\\"Diana Giraldo\\\",\\n\\\"identification\\\" : \\\"12355598\\\",\\n\\\"observations\\\" : \\\"Vendedor del área del oriente\\\"\\n}\\n```\",\n    \"12-3\": \"```\\n{\\n\\\"id\\\" : 1,\\n\\\"name\\\" : \\\"8 días\\\",\\n\\\"days\\\" : 8\\n}\\n```\",\n    \"13-3\": \"```\\n{\\n\\\"address\\\" : \\\"Calle principal #45\\\",\\n\\\"city\\\" : \\\"Barcelona\\\"\\n}\\n```\",\n    \"16-0\": \"type\",\n    \"16-1\": \"Array\",\n    \"16-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    \"16-3\": \"['provider','client']\",\n    \"17-0\": \"internalContacts\",\n    \"17-1\": \"Array\",\n    \"17-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    \"17-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    \"3-0\": \"identification (Perú)\",\n    \"3-1\": \"Object\",\n    \"3-2\": \"**Solo para versión Alegra Perú.** \\n\\nObjeto identification que indica la identificación del contacto.\\n\\nContiene los siguientes atributos:\\n\\n* type: India el tipo de identificación, los valores posibles son (SIN RUC, RUC, DNI, CDI, PP, CE).\\n* number: Indica el  número de identificación.\",\n    \"3-3\": \"{\\n    \\\"identification\\\": {\\n        \\\"type\\\": \\\"RUC\\\",\\n        \\\"number\\\": 12345678911\\n    }\\n}\",\n    \"14-0\": \"address (México)\",\n    \"15-0\": \"address (Perú)\",\n    \"14-2\": \"**Solo para versión Alegra México.** \\n\\nObjeto que contiene la información de la dirección del contacto.\\n\\nContiene los siguientes atributos:\\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    \"15-2\": \"**Solo para versión Alegra Perú.** \\n\\nObjeto que contiene la información de la dirección del contacto.\\n\\nContiene los siguientes atributos:\\n\\n*address: Indica la dirección del contacto.\\n*state: Indica el departamento del contacto.\\n*city: Indica la provincial del contacto.\\n*district: Indica el distrito del contacto.\\n*urbanization: Indica la urbanización del contacto.\\n*ubigeoCode: Indica el código ubigeo.\",\n    \"14-3\": \"```\\n{\\n\\\"street\\\" : \\\"Avenida Primero de Mayo\\\",\\n                        \\\"exteriorNumber\\\" : 95,\\n                        \\\"interiorNumber\\\" : \\\"1B\\\",\\n                        \\\"colony\\\" : \\\"Benito Juaréz\\\",\\n                        \\\"country\\\" : \\\"México\\\",\\n                        \\\"locality\\\" : \\\"\\\",\\n                        \\\"municipality\\\" : \\\"\\\",\\n                        \\\"state\\\" : \\\"D.F\\\",\\n                        \\\"zipCode\\\" : \\\"12345\\\"\\n}\\n```\",\n    \"15-3\": \"{\\n\\\"address\\\": \\\"AV SAN MARTIN 101\\\",\\n                  \\t\\t\\t\\\"state\\\": \\\"LORETO\\\",\\n                  \\t\\t\\t\\\"city\\\": \\\"MARISCAL RAMON CASTILLA\\\",\\n                  \\t\\t\\t\\\"district\\\": \\\"YAVARI\\\",\\n                  \\t\\t\\t\\\"urbanization\\\": \\\"SAN RAFAEL\\\",\\n                  \\t\\t\\t\\\"ubigeoCode\\\": 150603\\n}\",\n    \"18-3\": \"G01\",\n    \"18-2\": \"**Solo para versión Alegra México.** \\nIndica la clave del Uso CFDI asociada al contacto.\",\n    \"18-0\": \"cfdiUse (México)\",\n    \"18-1\": \"String\"\n  },\n  \"cols\": 4,\n  \"rows\": 19\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.", "4-0": "email", "4-1": "String", "4-2": "Correo electrónico del contacto.", "5-0": "phonePrimary", "6-0": "phoneSecondary", "5-2": "Número telefónico principal del contacto.", "6-2": "Número telefónico secundario del contacto.", "5-1": "String", "6-1": "String", "7-0": "fax", "8-0": "mobile", "7-2": "Fax del contacto.", "8-2": "Número de célular/móvil.", "7-1": "String", "8-1": "String", "9-0": "observations", "10-0": "priceList", "9-2": "Observaciones del contacto.", "10-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.", "10-1": "Object", "9-1": "String", "11-0": "seller", "11-1": "Object", "11-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.", "12-0": "term", "12-1": "Object", "12-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.", "13-0": "address", "13-1": "Object", "13-2": "Objeto que contiene la información de la dirección del contacto.\n\nContiene los siguientes atributos:\n* address : Indica la dirección del contacto.\n* city: Ciudad del contacto.", "h-3": "Ejemplo", "0-3": "5", "1-3": "Juan Pablo Mesa", "2-3": "901.589.545-2", "4-3": "micorreo@miempresa.com", "5-3": "+(99)(999) 999-99-99", "6-3": "(999) 999-99-99", "7-3": "(999) 999-99-99", "8-3": "333 33 33", "9-3": "", "10-3": "```\n{\n \"id\" : 5,\n \"name\": \"Distribuidor\"\n}\n```", "11-3": "```\n{\n\"id\" : \"12\",\n\"name\" : \"Diana Giraldo\",\n\"identification\" : \"12355598\",\n\"observations\" : \"Vendedor del área del oriente\"\n}\n```", "12-3": "```\n{\n\"id\" : 1,\n\"name\" : \"8 días\",\n\"days\" : 8\n}\n```", "13-3": "```\n{\n\"address\" : \"Calle principal #45\",\n\"city\" : \"Barcelona\"\n}\n```", "16-0": "type", "16-1": "Array", "16-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.", "16-3": "['provider','client']", "17-0": "internalContacts", "17-1": "Array", "17-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).", "17-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```", "3-0": "identification (Perú)", "3-1": "Object", "3-2": "**Solo para versión Alegra Perú.** \n\nObjeto identification que indica la identificación del contacto.\n\nContiene los siguientes atributos:\n\n* type: India el tipo de identificación, los valores posibles son (SIN RUC, RUC, DNI, CDI, PP, CE).\n* number: Indica el número de identificación.", "3-3": "{\n \"identification\": {\n \"type\": \"RUC\",\n \"number\": 12345678911\n }\n}", "14-0": "address (México)", "15-0": "address (Perú)", "14-2": "**Solo para versión Alegra México.** \n\nObjeto que contiene la información de la dirección del contacto.\n\nContiene los siguientes atributos:\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.", "15-2": "**Solo para versión Alegra Perú.** \n\nObjeto que contiene la información de la dirección del contacto.\n\nContiene los siguientes atributos:\n\n*address: Indica la dirección del contacto.\n*state: Indica el departamento del contacto.\n*city: Indica la provincial del contacto.\n*district: Indica el distrito del contacto.\n*urbanization: Indica la urbanización del contacto.\n*ubigeoCode: Indica el código ubigeo.", "14-3": "```\n{\n\"street\" : \"Avenida Primero de Mayo\",\n \"exteriorNumber\" : 95,\n \"interiorNumber\" : \"1B\",\n \"colony\" : \"Benito Juaréz\",\n \"country\" : \"México\",\n \"locality\" : \"\",\n \"municipality\" : \"\",\n \"state\" : \"D.F\",\n \"zipCode\" : \"12345\"\n}\n```", "15-3": "{\n\"address\": \"AV SAN MARTIN 101\",\n \t\t\t\"state\": \"LORETO\",\n \t\t\t\"city\": \"MARISCAL RAMON CASTILLA\",\n \t\t\t\"district\": \"YAVARI\",\n \t\t\t\"urbanization\": \"SAN RAFAEL\",\n \t\t\t\"ubigeoCode\": 150603\n}", "18-3": "G01", "18-2": "**Solo para versión Alegra México.** \nIndica la clave del Uso CFDI asociada al contacto.", "18-0": "cfdiUse (México)", "18-1": "String" }, "cols": 4, "rows": 19 } [/block]