{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/contacts","auth":"required","examples":{"codes":[{"name":"Contacto simple","language":"json","code":"{\n  \"name\": \"Acrecer\"\n}"},{"name":"Contacto simple - México","language":"json","code":"{\n  \"name\": \"Acrecer\",\n  \"identification\" : \"XAXX010101000\"\n}"},{"name":"Contacto completo","language":"json","code":"        {\n                \"name\": \"Acrecer\",\n                \"identification\": \"963.654.988\",\n                \"email\": \"prueba2:::at:::alegra.com\",\n                \"phonePrimary\": \"111 11 11\",\n                \"seller\": {\n                        \"id\" : \"52\"\n                        },\n                \"term\" : \n                        {\n                            \"id\" : 2\n                        },\n                \"type\" : [\"client\"],\n                \"address\" : {\n                    \"address\" : \"Avenida Madison\",\n                    \"city\" : \"New York, USA\"\n                    },\n                \"internalContacts\" : [\n                            {\n                                \"name\" : \"Lina\",\n                                \"lastName\" : \"Montoya\",\n                                \"email\" : \"[email protected]\",\n                                \"phone\" : \"123 45 67 ext 25\",\n                                \"mobile\" : \"(333) 333 33 33\",\n                                \"sendNotifications\" : \"no\"\n                            }\n                    ]\n        }"},{"name":"Contacto simple Perú","language":"json","code":"{\n  \"name\": \"Acrecer\",\n  \"identification\": {\n  \t\"type\": \"RUC\",\n    \"number\": \"12345678911\"\n  }\n}"},{"code":"{\n  \"name\": \"Acrecer\",\n  \"identification\": {\n  \t\"type\": \"01\",\n    \"number\": \"123456789\"\n  },\n  \"address\": {\n    \"address\" : \"Calle 3\",\n    \"department\" : \"Limón\",\n    \"city\" : \"Pococí\",\n    \"district\" : \"Colorado\",\n    \"neighborhood\" : \"Verdades\"\n  }\n}","language":"text","name":"Contacto simple Costa Rica"},{"name":"Contacto simple Argentina","language":"json","code":"{\n    \"name\": \"Carlos Magno 11\",\n    \"identification\": \"40012947\",\n    \"address\": {\n    \t \"province\": \"Ciudad Autónoma de Buenos Aires\",\n       \"city\": \"Ciudad autónoma de buenos aires\",\n       \"address\": \"Diagonal 38 # 13-98\",\n       \"postalCode\": \"12111313\"\n    },\n    \"ivaCondition\": \"IVA_RESPONSABLE\"\n}\n\n"}]},"method":"post","params":[{"name":"name","type":"string","default":"","desc":"Nombre del contacto. Longitud máxima permitida: 90. Para Colombia, si el contacto es una persona natural, se debe enviar este atributo como un objeto, que contiene los atirbutos: `firstName` (obligatorio), `secondName` (opcional), `lastName` (obligatorio).","required":true,"in":"body","ref":"","_id":"56b0cbcbce5f410d0056c9c7"},{"name":"identification","type":"string","default":"","desc":"Número de identificación del contacto. Por ejemplo cédula, RNC, número de pasaporte, RFC. En versión Alegra México es obligatorio.   Longitud máxima permitida: 45.","required":false,"in":"body","ref":"","_id":"56b0cd936d004b17008065cf"},{"name":"identification (Perú y Argentina)","type":"object","default":"","desc":"Para Perú y Argentina, el atributo identification es obligatorio, para argentina es obligatorio si la empresa tiene facturación electrónica activada, un objeto compuesto por los siguientes atributos: `type(string)` tipo de identificación perú (SIN RUC, RUC, DNI, PP, CE, CDI), Argentina (CUIT, CDI, CI, PASSPORT, DNI, OTHER) `number (string)` número de identificación.","required":true,"in":"body","ref":"","_id":"59bc0cf9c7d95f0026eb0767"},{"name":"identification (Chile)","type":"string","default":"","desc":"Para Chile, este campo es obligatorio si se quiere emitir documentos para facturación electrónica, el formato debe ser el mismo que los documentos RUT en Chile, es decir, de 6 a 8 dígitos, un guion (\"-\") y otro dígito o una K (6666666-K)","required":false,"in":"body","ref":"","_id":"5ea7645fdbdc2d021e0a79e2"},{"name":"identificationObject","type":"object","default":"","desc":"Para Costa Rica y Colombia, el atributo identificationObject es un objeto compuesto por los siguientes atributos: `type(string)`  tipo de identificación (Consulta el catálogo de parámetros correspondiente a cada país haciendo clic [aquí](https://developer.alegra.com/docs/colombia)), `number (string)` número de identificación. Parámetro obligatorio si se tiene facturación electrónica activa.","required":false,"in":"body","ref":"","_id":"5bcf8d9e31103600383381ce"},{"name":"phonePrimary","type":"string","default":"","desc":"Número telefónico principal del contacto.  Longitud máxima permitida: 45.","required":false,"in":"body","ref":"","_id":"56b0cd936d004b17008065ce"},{"name":"phoneSecondary","type":"string","default":"","desc":"Número telefónico secundario del contacto.  Longitud máxima permitida: 45.","required":false,"in":"body","ref":"","_id":"56b0cd936d004b17008065cd"},{"name":"fax","type":"string","default":"","desc":"Fax del contacto.  Longitud máxima permitida: 45.","required":false,"in":"body","ref":"","_id":"56b0cd936d004b17008065cc"},{"name":"mobile","type":"string","default":"","desc":"Número de célular/móvil.  Longitud máxima permitida: 45.","required":false,"in":"body","ref":"","_id":"56b11166135ec20d00bafa04"},{"name":"observations","type":"string","default":"","desc":"Observaciones del cliente.  Longitud máxima permitida: 500.","required":false,"in":"body","ref":"","_id":"56b0cd936d004b17008065cb"},{"name":"email","type":"string","default":"","desc":"Correo electrónico del contacto.  Longitud máxima permitida: 100.","required":false,"in":"body","ref":"","_id":"56b0cd936d004b17008065ca"},{"name":"ignoreRepeated","type":"boolean","default":"","desc":"Enviar en false si desea que Alegra verifique si existe otro contacto con la misma identificación y si es así no crear el contacto.  Por defecto permite crear contactos con la misma identificación.","required":false,"in":"body","ref":"","_id":"56b11233f48f270d00e0dd5d"},{"name":"priceList","type":"object","default":"","desc":"Objecto PriceList que indica la lista de precios asociada al contacto. Se puede enviar el id de la lista de precios directamente.","required":false,"in":"body","ref":"","_id":"56b11233f48f270d00e0dd5c"},{"name":"seller","type":"object","default":"","desc":"Objecto Seller que indica el vendedor asociado al contacto. Se puede enviar el id del vendedor directamente.","required":false,"in":"body","ref":"","_id":"56b11233f48f270d00e0dd5b"},{"name":"term","type":"object","default":"","desc":"Objecto Term que indica el término de pago del contacto. Se puede enviar el id del término de pago directamente.","required":false,"in":"body","ref":"","_id":"56b11233f48f270d00e0dd5a"},{"name":"address","type":"object","default":"","desc":"Objeto Address que contiene la información de la dirección del contacto, compuesto por los atributos `address (string)` dirección del contacto y `city (string)` Ciudad del contacto.","required":false,"in":"body","ref":"","_id":"56b11233f48f270d00e0dd59"},{"name":"address (México)","type":"object","default":"","desc":"Para méxico, el Objeto address con la información de la dirección del contacto está compuesto por los siguientes atributos:  `address (string)`: dirección del contacto; `city (string)`: Ciudad del contacto.  Para Alegra México, este objeto debe contener los atributos : `street (string)`: Calle del contacto; `exteriorNumber (string)` : Número de exterior; `interiorNumber (string)`: Número de interior; `colony (string)`: Colonia del contacto; `country (string, obligatorio)`: país del contacto, si con el contacto se desea timbrar documentos se debe especificar el codigo de pais de 3 digitos de acuerdo a la ISO 3166-1 alpha-3 (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3).; `locality (string)`: localidad; `municipality (string)`: Municipio; `state (string, obligatorio)`: estado, `zipCode (number)`: código postal del usuario.","required":false,"in":"body","ref":"","_id":"59bc09d115d1e10024261e0b"},{"name":"address (Perú)","type":"object","default":"","desc":"Para perú, el Objeto address que contiene la información de la dirección del contacto está compuesto por los siguientes atributos: `address (string)` dirección, `state (string)` departamento, `city (string)` provincia, `urbanization (string)` urbanización, `district (string)` distrito, `ubigeoCode (number)` código ubigeo.","required":false,"in":"body","ref":"","_id":"59bc09d115d1e10024261e0a"},{"name":"address (Costa Rica)","type":"object","default":"","desc":"Para Costa Rica, el objeto address con la información de la dirección del contacto está compuesto por los siguientes atributos:  `address (string)` Otras señas, `department (string)` Provincia, `city (string)` Cantón, `district (string)` Distrito, `neighborhood (string)` Barrio. Este atributo se vuelve obligatorio si el tipo de identificación es diferente a \"PE\".","required":false,"in":"body","ref":"","_id":"5bcf8d9e31103600383381cd"},{"name":"address (Colombia)","type":"string","default":"","desc":"Para Colombia, el objeto address con la información de la dirección del contacto está compuesto por los siguientes atributos:  `address (string)` Dirección, `department (string)` Departamento, `city (string)` Ciudad, `country (string)` País.","required":false,"in":"body","ref":"","_id":"5bedd15e1bf88e0037a2180d"},{"name":"address (Argentina)","type":"string","default":"","desc":"Para Argentina, el objeto address con la información de la dirección del contacto está compuesto por los siguientes atributos:  `address (string)` Dirección, `province (string)` Provincia, `city (string)` Ciudad, `postalCode (string)` Código Postal.","required":true,"in":"body","ref":"","_id":"5d9fafdfba6bae044c27e685"},{"name":"address (Chile)","type":"object","default":"","desc":"Para Chile, el objeto address con la información de la dirección del contacto está compuesto por los siguientes atributos:  'city (string)` ciudad, `region (string)` región, `commune (string)` comuna y `description (string)` otras señas.","required":false,"in":"body","ref":"","_id":"5e6017e34f75a7001adf69de"},{"name":"type","type":"array_string","default":"","desc":"Array que incluye el tipo de contacto, las opciones posibles son 'client', 'provider', se puede incluir en el array una de la anteriores opciones, las dos opciones o ninguna. Si solo se desea asociar a un tipo se puede enviar el tipo directamente como String y no en Array.","required":false,"in":"body","ref":"","_id":"56b11233f48f270d00e0dd58"},{"name":"cfdiUse","type":"string","default":"","desc":"Para México, representa la clave del Uso CFDI.","required":false,"in":"body","ref":"","_id":"5a01de6ec2f2ea001c4b7b68"},{"name":"internalContacts","type":"array_object","default":"","desc":"Array de objetos internalContact que indica las personas asociadas al contacto.  Cada objeto deben tener los siguientes atributos `name (string, obligatorio)`: nombre del contacto interno;  `lastname (string)`: apellido del contacto interno; `email (string)` : correo electrónico; `phone (string)`: teléfono del contacto; `sendNotifications (boolean)`: enviar true si se desea que a la persona se le envíe notificaciones de vencimiento de factura.","required":false,"in":"body","ref":"","_id":"56b11233f48f270d00e0dd57"},{"name":"kindOfPerson","type":"string","default":"","desc":"Para Colombia, indica el tipo de persona, Consulta el catálogo de parámetros correspondiente a cada país haciendo clic [aquí](https://developer.alegra.com/docs/colombia). Parámetro obligatorio si se tiene facturación electrónica activa.","required":false,"in":"body","ref":"","_id":"5bedd15e1bf88e0037a2180c"},{"name":"regime","type":"string","default":"","desc":"Para Colombia, indica el régimen al que pertenece el contacto. Consulta el catálogo de parámetros correspondiente a cada país haciendo clic [aquí](https://developer.alegra.com/docs/colombia). Parámetro obligatorio si se tiene facturación electrónica activa.","required":false,"in":"body","ref":"","_id":"5bedd15e1bf88e0037a2180b"},{"name":"paymentMethod (México)","type":"string","default":"","desc":"Para México, representa la forma de pago del contacto. Las opciones posibles son: `cash` Efectivo, `debit-card` Tarjeta de débito, `credit-card` Tarjeta de crédito, `service-card` Tarjeta de servicios, `transfer` Transferencia electrónica de fondos, `check` Cheque nominativo, `electronic-wallet` Monedero electrónico, `electronic-money` Dinero electrónico, `grocery-voucher` Vale de despensa, `dation-payment` Dación en pago, `subrogation-payment` Pago por subrogación, `allocation-payment` Pago por consignación, `forgiveness` Condonación, `compensation` Compensación, `novation` Novación, `misunderstanding` Confusión, `debt-remission` Remisión de deuda, `prescription-or-expiration` Prescripción o caducidad, `creditor-satisfaction` A satisfacción del acreedor. Si el paymentType es \"PPD\" solo admite el paymentMethod `other`. Se debe ingresar en minúscula.","required":false,"in":"body","ref":"","_id":"5d6ec0c7f0d0e60011999cb2"},{"name":"paymentType (México)","type":"string","default":"","desc":"Para México, representa el método de la factura. Admite los valores `PUE` para Pago en Una sola Exhibición y `PPD` para Pago en Parcialidades o Diferido. Se debe ingresar en mayúscula.","required":false,"in":"body","ref":"","_id":"5d6ec0c7f0d0e60011999cb1"},{"name":"ivaCondition (Argentina)","type":"string","default":"","desc":"Para Argentina, como valor obligatorio se debe especificar la condición del iva. Las opciones posibles son: `IVA_RESPONSABLE` IVA responsable inscripto, `IVA_RESPONSABLE_NO_INSCRIPT` IVA responsable no inscripto, `IVA_EXEMPT` IVA sujeto exento, `FINAL_CONSUMER` Consumidor final, `UNIQUE_TRIBUTE_RESPONSABLE` Responsable monotributo, `PROVIDER_FROM_EXTERIOR` Proveedor del exterior, `CLIENT_FROM_EXTERIOR` Cliente del exterior, `IVA_RELEASED_LAW_19640` IVA Liberado - Ley 19.640, `UNIQUE_TRIBUTE_SOCIAL` Monotributista Social, `IVA_NOT_REACHED` IVA No alcanzado","required":true,"in":"body","ref":"","_id":"5d9fafdfba6bae044c27e684"},{"name":"statementAttached","type":"string","default":"","desc":"Indica si el enlace del estado de cuenta del cliente se debe incluir en los correos que se envían al cliente, los valores validos son: `yes` o `no`","required":false,"in":"body","ref":"","_id":"5e418f801a12c60032f79e9d"},{"name":"giro","type":"string","default":"","desc":"Para Chile, indica el giro de negocio del contacto. Parámetro obligatorio si se tiene facturación electrónica activa.","required":false,"in":"body","ref":"","_id":"5e6017e34f75a7001adf69d4"},{"name":"operationType","type":"string","default":"","desc":"Para México, representa el tipo de operación a la que se somete el contacto, sus valores posibles son: `PROFESSIONAL_SERVICES`, `PROPERTY_LEASING` u `OTHERS`","required":false,"in":"body","ref":"","_id":"5ee0276e71f242006ac2e878"},{"name":"thirdType","type":"string","default":"","desc":"Para México, representa el tipo de tercero al que pertenece el contacto, sus valores posibles son: `NATIONAL` o `FOREIGN`. Si es `FOREIGN` el campo `fiscalId` debe enviarse y es obligatorio.","required":false,"in":"body","ref":"","_id":"5ee0276e71f242006ac2e877"},{"name":"fiscalId","type":"string","default":"","desc":"Para México, representa el ID fiscal del proveedor. Es requerido sólo cuando `thirdType` está presente y es `FOREIGN`","required":false,"in":"body","ref":"","_id":"5ee0276e71f242006ac2e876"}],"results":{"codes":[{"status":201,"language":"json","code":"{\n                \"id\": 1,\n                \"name\": \"Acrecer\",\n                \"identification\": \"963.654.988\",\n                \"email\": \"[email protected]\",\n\t\t\t\t\t\t\t\t\"phonePrimary\": \"111 11 11\",\n                \"phoneSecondary\": \"\",\n                \"fax\": \"\",\n                \"mobile\": \"(333) 555-55-55\",\n                \"observations\": \"\",\n                \"type\" : [\"client\"],\n                \"address\" : {\n                        \"address\" : \"Avenida Madison\",\n                        \"city\" : \"New York, USA\"\n                },\n                \"seller\": {\n                        \"id\" : \"52\",\n                        \"name\" : \"Diana Giraldo\",\n                        \"identification\" : 560,\n                        \"observations\" : 320\n                },\n                \"term\" : {\n                        \"id\" : 2,\n                        \"name\" : \"8 días\",\n                        \"days\" : 8\n                },\n                \"priceList\" : null,\n                \"internalContacts\" : [\n\t\t\t\t\t\t\t\t\t\t{\n                        \"id\" : 1,\n                        \"name\" : \"Lina\",\n                        \"lastName\" : \"Montoya\",\n                        \"email\" : \"[email protected]\",\n                        \"phone\" : \"123 45 67 ext 25\",\n                        \"mobile\" : \"(333) 333 33 33\",\n                        \"sendNotifications\" : \"no\"\n                \t}\n                ] \n            }","name":"Creación exitosa"},{"status":400,"language":"json","code":"{ \n\t\"error\": \"La información para crear el modelo no existe o es inválida\",\n  \"code\" : 400\n}","name":""},{"code":"{\n                \"id\": 1,\n                \"name\": \"Acrecer\",\n                \"identification\": \"XAXX010101000\",\n                \"email\": \"[email protected]\",\n\t\t\t\t\t\t\t\t\"phonePrimary\": \"111 11 11\",\n                \"phoneSecondary\": \"\",\n                \"fax\": \"\",\n                \"mobile\": \"(333) 555-55-55\",\n                \"observations\": \"\",\n  \t\t\t\t\t\t\t\"cfdiUse\": \"G01\",\n\t\t\t\t\t\t\t  \"paymentType\": \"PUE\",\n\t\t\t\t\t\t    \"paymentMethod\": \"credit-card\",\n                \"type\" : [\"client\"],\n                \"address\" : {\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                \"seller\": {\n                        \"id\" : \"52\",\n                        \"name\" : \"Diana Giraldo\",\n                        \"identification\" : 560,\n                        \"observations\" : 320\n                        },\n                \"term\" : \n                        {\n                            \"id\" : 2,\n                            \"name\" : \"8 días\",\n                            \"days\" : 8\n                        },\n                \"priceList\" : null,\n                \"internalContacts\" : [\n                    {\n                    \"id\" : 1,\n                   \"name\" : \"Lina\",\n                   \"lastName\" : \"Montoya\",\n                   \"email\" : \"[email protected]\",\n                   \"phone\" : \"123 45 67 ext 25\",\n                   \"mobile\" : \"(333) 333 33 33\",\n                   \"sendNotifications\" : \"no\"\n                }\n                ]\n            }","language":"json","status":201,"name":"Creación exitosa - México"},{"name":"Creación exitosa Perú","status":201,"language":"json","code":"{\n  \"id\": 1,\n  \"name\": \"Acrecer\",\n  \"identification\": {\n    \"type\": \"RUC\",\n    \"number\": \"12345678911\"\n  },\n  \"email\": \"\",\n  \"phonePrimary\": \"\",\n  \"phoneSecondary\": \"\",\n  \"fax\": \"\",\n  \"mobile\": \"\",\n  \"observations\": \"\",\n  \"type\" : [\"client\"],\n  \"address\" : {\n    \"address\": \"\",\n    \"state\": \"\",\n    \"city\": \"\",\n    \"district\": \"\",\n    \"urbanization\": \"\",\n    \"ubigeoCode\": \"\"\n  }             \n}"},{"name":"Creación exitosa Costa Rica","status":201,"language":"json","code":"{\n\t\"id\": 1,\n  \"name\": \"Acrecer\",\n  \"identification\": {\n  \t\"type\": \"01\",\n    \"number\": \"123456789\"\n  },\n  \"email\": \"\",\n  \"phonePrimary\": \"\",\n  \"phoneSecondary\": \"\",\n  \"fax\": \"\",\n  \"mobile\": \"\",\n  \"observations\": \"\",\n  \"type\" : [\"client\"],\n  \"address\": {\n    \"address\" : \"Calle 3\",\n    \"department\" : \"Limón\",\n    \"city\" : \"Pococí\",\n    \"district\" : \"Colorado\",\n    \"neighborhood\" : \"Verdades\"\n  }\n}"},{"name":"Creación exitosa Argentina","status":201,"language":"json","code":"{\n    \"id\": \"24\",\n    \"name\": \"Carlos Perez\",\n    \"identification\": \"40012947\",\n    \"email\": \"[email protected]\",\n    \"phonePrimary\": null,\n    \"phoneSecondary\": null,\n    \"fax\": null,\n    \"mobile\": null,\n    \"observations\": null,\n    \"ivaCondition\": \"IVA_RESPONSABLE\",\n    \"address\": {\n        \"province\": \"Ciudad Autónoma de Buenos Aires\",\n        \"city\": \"Ciudad autónoma de buenos aires\",\n        \"address\": \"Diagonal 38 # 13-98\",\n        \"postalCode\": \"12111313\"\n    },\n    \"type\": [],\n    \"seller\": null,\n    \"term\": null,\n    \"priceList\": null,\n    \"internalContacts\": []\n}"}]},"settings":""},"next":{"description":"","pages":[]},"title":"Crear contacto","type":"endpoint","slug":"crear-contacto","excerpt":"","body":"","updates":["59e4b6b79b239f00307710b0","5a3da3d59f409c002af3bc47"],"order":3,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"56b1110d02f4bc0d006ce29d","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Contactos","slug":"contactos","order":2,"from_sync":false,"reference":true,"_id":"56b4b2faeed075230097d688","__v":0,"project":"56abd2434e4b730d009eb10a","version":"56abd2434e4b730d009eb10d","createdAt":"2016-02-05T14:34:34.496Z"},"createdAt":"2016-02-02T20:26:53.081Z","editedParams2":true,"parentDoc":null,"version":{"version":"1","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"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","5e3098aba5919200612d0c33","5e8ca028538a310018ccd2df","5e9f0d4c720ad8006c6c7dc1","5ea9c2f382fcd2003df9f412","5ec7defc6aa2be001e7504f5","5ed8f716a8308c0412b5473a","5ed9274fe5a9b8041fd1df43","5ed92afa0d09d60253220b3f","5efcff9cd7e1be00118e8272"],"_id":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","releaseDate":"2016-01-29T20:57:39.712Z","__v":39,"createdAt":"2016-01-29T20:57:39.712Z"},"githubsync":"","project":"56abd2434e4b730d009eb10a","user":"56abd213d4432d1900eed227","editedParams":true,"__v":50}

postCrear contacto


Definition

{{ api_url }}{{ page_api_url }}

Parameters

Body Params

name:
required
string
Nombre del contacto. Longitud máxima permitida: 90. Para Colombia, si el contacto es una persona natural, se debe enviar este atributo como un objeto, que contiene los atirbutos: `firstName` (obligatorio), `secondName` (opcional), `lastName` (obligatorio).
identification:
string
Número de identificación del contacto. Por ejemplo cédula, RNC, número de pasaporte, RFC. En versión Alegra México es obligatorio. Longitud máxima permitida: 45.
identification:
required
object
Para Perú y Argentina, el atributo identification es obligatorio, para argentina es obligatorio si la empresa tiene facturación electrónica activada, un objeto compuesto por los siguientes atributos: `type(string)` tipo de identificación perú (SIN RUC, RUC, DNI, PP, CE, CDI), Argentina (CUIT, CDI, CI, PASSPORT, DNI, OTHER) `number (string)` número de identificación.
identification:
string
Para Chile, este campo es obligatorio si se quiere emitir documentos para facturación electrónica, el formato debe ser el mismo que los documentos RUT en Chile, es decir, de 6 a 8 dígitos, un guion ("-") y otro dígito o una K (6666666-K)
identificationObject:
object
Para Costa Rica y Colombia, el atributo identificationObject es un objeto compuesto por los siguientes atributos: `type(string)` tipo de identificación (Consulta el catálogo de parámetros correspondiente a cada país haciendo clic [aquí](https://developer.alegra.com/docs/colombia)), `number (string)` número de identificación. Parámetro obligatorio si se tiene facturación electrónica activa.
phonePrimary:
string
Número telefónico principal del contacto. Longitud máxima permitida: 45.
phoneSecondary:
string
Número telefónico secundario del contacto. Longitud máxima permitida: 45.
fax:
string
Fax del contacto. Longitud máxima permitida: 45.
mobile:
string
Número de célular/móvil. Longitud máxima permitida: 45.
observations:
string
Observaciones del cliente. Longitud máxima permitida: 500.
email:
string
Correo electrónico del contacto. Longitud máxima permitida: 100.
ignoreRepeated:
boolean
Enviar en false si desea que Alegra verifique si existe otro contacto con la misma identificación y si es así no crear el contacto. Por defecto permite crear contactos con la misma identificación.
priceList:
object
Objecto PriceList que indica la lista de precios asociada al contacto. Se puede enviar el id de la lista de precios directamente.
seller:
object
Objecto Seller que indica el vendedor asociado al contacto. Se puede enviar el id del vendedor directamente.
term:
object
Objecto Term que indica el término de pago del contacto. Se puede enviar el id del término de pago directamente.
address:
object
Objeto Address que contiene la información de la dirección del contacto, compuesto por los atributos `address (string)` dirección del contacto y `city (string)` Ciudad del contacto.
address:
object
Para méxico, el Objeto address con la información de la dirección del contacto está compuesto por los siguientes atributos: `address (string)`: dirección del contacto; `city (string)`: Ciudad del contacto. Para Alegra México, este objeto debe contener los atributos : `street (string)`: Calle del contacto; `exteriorNumber (string)` : Número de exterior; `interiorNumber (string)`: Número de interior; `colony (string)`: Colonia del contacto; `country (string, obligatorio)`: país del contacto, si con el contacto se desea timbrar documentos se debe especificar el codigo de pais de 3 digitos de acuerdo a la ISO 3166-1 alpha-3 (https://en.wikipedia.org/wiki/ISO_3166-1_alpha-3).; `locality (string)`: localidad; `municipality (string)`: Municipio; `state (string, obligatorio)`: estado, `zipCode (number)`: código postal del usuario.
address:
object
Para perú, el Objeto address que contiene la información de la dirección del contacto está compuesto por los siguientes atributos: `address (string)` dirección, `state (string)` departamento, `city (string)` provincia, `urbanization (string)` urbanización, `district (string)` distrito, `ubigeoCode (number)` código ubigeo.
address:
object
Para Costa Rica, el objeto address con la información de la dirección del contacto está compuesto por los siguientes atributos: `address (string)` Otras señas, `department (string)` Provincia, `city (string)` Cantón, `district (string)` Distrito, `neighborhood (string)` Barrio. Este atributo se vuelve obligatorio si el tipo de identificación es diferente a "PE".
address:
string
Para Colombia, el objeto address con la información de la dirección del contacto está compuesto por los siguientes atributos: `address (string)` Dirección, `department (string)` Departamento, `city (string)` Ciudad, `country (string)` País.
address:
required
string
Para Argentina, el objeto address con la información de la dirección del contacto está compuesto por los siguientes atributos: `address (string)` Dirección, `province (string)` Provincia, `city (string)` Ciudad, `postalCode (string)` Código Postal.
address:
object
Para Chile, el objeto address con la información de la dirección del contacto está compuesto por los siguientes atributos: 'city (string)` ciudad, `region (string)` región, `commune (string)` comuna y `description (string)` otras señas.
type:
array of strings
Array que incluye el tipo de contacto, las opciones posibles son 'client', 'provider', se puede incluir en el array una de la anteriores opciones, las dos opciones o ninguna. Si solo se desea asociar a un tipo se puede enviar el tipo directamente como String y no en Array.
cfdiUse:
string
Para México, representa la clave del Uso CFDI.
internalContacts:
array of objects
Array de objetos internalContact que indica las personas asociadas al contacto. Cada objeto deben tener los siguientes atributos `name (string, obligatorio)`: nombre del contacto interno; `lastname (string)`: apellido del contacto interno; `email (string)` : correo electrónico; `phone (string)`: teléfono del contacto; `sendNotifications (boolean)`: enviar true si se desea que a la persona se le envíe notificaciones de vencimiento de factura.
kindOfPerson:
string
Para Colombia, indica el tipo de persona, Consulta el catálogo de parámetros correspondiente a cada país haciendo clic [aquí](https://developer.alegra.com/docs/colombia). Parámetro obligatorio si se tiene facturación electrónica activa.
regime:
string
Para Colombia, indica el régimen al que pertenece el contacto. Consulta el catálogo de parámetros correspondiente a cada país haciendo clic [aquí](https://developer.alegra.com/docs/colombia). Parámetro obligatorio si se tiene facturación electrónica activa.
paymentMethod:
string
Para México, representa la forma de pago del contacto. Las opciones posibles son: `cash` Efectivo, `debit-card` Tarjeta de débito, `credit-card` Tarjeta de crédito, `service-card` Tarjeta de servicios, `transfer` Transferencia electrónica de fondos, `check` Cheque nominativo, `electronic-wallet` Monedero electrónico, `electronic-money` Dinero electrónico, `grocery-voucher` Vale de despensa, `dation-payment` Dación en pago, `subrogation-payment` Pago por subrogación, `allocation-payment` Pago por consignación, `forgiveness` Condonación, `compensation` Compensación, `novation` Novación, `misunderstanding` Confusión, `debt-remission` Remisión de deuda, `prescription-or-expiration` Prescripción o caducidad, `creditor-satisfaction` A satisfacción del acreedor. Si el paymentType es "PPD" solo admite el paymentMethod `other`. Se debe ingresar en minúscula.
paymentType:
string
Para México, representa el método de la factura. Admite los valores `PUE` para Pago en Una sola Exhibición y `PPD` para Pago en Parcialidades o Diferido. Se debe ingresar en mayúscula.
ivaCondition:
required
string
Para Argentina, como valor obligatorio se debe especificar la condición del iva. Las opciones posibles son: `IVA_RESPONSABLE` IVA responsable inscripto, `IVA_RESPONSABLE_NO_INSCRIPT` IVA responsable no inscripto, `IVA_EXEMPT` IVA sujeto exento, `FINAL_CONSUMER` Consumidor final, `UNIQUE_TRIBUTE_RESPONSABLE` Responsable monotributo, `PROVIDER_FROM_EXTERIOR` Proveedor del exterior, `CLIENT_FROM_EXTERIOR` Cliente del exterior, `IVA_RELEASED_LAW_19640` IVA Liberado - Ley 19.640, `UNIQUE_TRIBUTE_SOCIAL` Monotributista Social, `IVA_NOT_REACHED` IVA No alcanzado
statementAttached:
string
Indica si el enlace del estado de cuenta del cliente se debe incluir en los correos que se envían al cliente, los valores validos son: `yes` o `no`
giro:
string
Para Chile, indica el giro de negocio del contacto. Parámetro obligatorio si se tiene facturación electrónica activa.
operationType:
string
Para México, representa el tipo de operación a la que se somete el contacto, sus valores posibles son: `PROFESSIONAL_SERVICES`, `PROPERTY_LEASING` u `OTHERS`
thirdType:
string
Para México, representa el tipo de tercero al que pertenece el contacto, sus valores posibles son: `NATIONAL` o `FOREIGN`. Si es `FOREIGN` el campo `fiscalId` debe enviarse y es obligatorio.
fiscalId:
string
Para México, representa el ID fiscal del proveedor. Es requerido sólo cuando `thirdType` está presente y es `FOREIGN`

Examples


Result Format


User Information

Try It Out

post
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}