{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/company","auth":"required","examples":{"codes":[]},"method":"put","params":[{"name":"name","type":"string","default":"","desc":"Nombre de la empresa. Longitud máxima permitida: 90. Para Colombia, si la compañía es de una persona natural, se debe enviar este atributo como un objeto, que contiene los atirbutos: `firstName` (obligatorio), `secondName` (opcional), `lastName` (obligatorio).","required":false,"in":"body","ref":"","_id":"57488481db76422200d95887"},{"name":"address","type":"object","default":"","desc":"Objeto Address que contiene la dirección de la empresa, compuesto por los atributos `address (string)` dirección y `city (string)` Ciudad.","required":false,"in":"body","ref":"","_id":"57488481db76422200d95886"},{"name":"address (méxico)","type":"object","default":"","desc":"Para Alegra México, este objeto debe contener los atributos : `street (string)`: Calle de la empresa; `exteriorNumber (string)` : Número de exterior; `interiorNumber (string)`: Número de interior; `colony (string)`: Colonia de la empresa; `country (string, obligatorio)`: país de la empresa; `locality (string)`: localidad; `municipality (string)`: Municipio; `state (string, obligatorio)`: estado, `zipCode (number)`: código postal de la empresa.","required":false,"in":"body","ref":"","_id":"59bc2e4e26ac9b0010a8b76d"},{"name":"address (perú)","type":"object","default":"","desc":"Para perú, el Objeto address que contiene la información de la dirección de la empresa 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":"59bc2e4e26ac9b0010a8b76c"},{"name":"address (Costa Rica)","type":"object","default":"","desc":"Para Costa Rica, el objeto address con la información de la dirección de la compañía 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 \"00\".","required":false,"in":"body","ref":"","_id":"5bcf89a54c0907005cc026e0"},{"name":"address (Colombia)","type":"string","default":"","desc":"Para Colombia, el objeto address con la información de la dirección de la compañía está compuesto por los siguientes atributos:  `address (string)` Dirección, `department (string)` Departamento, `city (string)` Ciudad, `zipCode (string)` Código postal.","required":false,"in":"body","ref":"","_id":"5bedd6849b49e8004462dcb2"},{"name":"address (Chile)","type":"string","default":"","desc":"Para Chile, el objeto address con la información de la dirección de la compañía 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":"5e5fdd580a1d0b005a07c0dd"},{"name":"identification","type":"string","default":"","desc":"Identificación de la empresa. Ej RFC, cédula, NIT, RUC, entre otros. Para la versión Alegra Perú es obligatorio el numero de identificación del RUC.","required":false,"in":"body","ref":"","_id":"57488481db76422200d95885"},{"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":"5bcf89a54c0907005cc026df"},{"name":"email","type":"string","default":"","desc":"Correo electrónico de la empresa.","required":false,"in":"body","ref":"","_id":"57488481db76422200d95884"},{"name":"phone","type":"string","default":"","desc":"Teléfono de la empresa.","required":false,"in":"body","ref":"","_id":"57488481db76422200d95883"},{"name":"website","type":"string","default":"","desc":"Página web de la empresa.","required":false,"in":"body","ref":"","_id":"57488481db76422200d95882"},{"name":"decimalPrecision","type":"int","default":"","desc":"Indica la precisión decimal que tiene configurada la empresa para la creación de documentos. Las facturas de venta y demás documentos que se creen se aproximan teniendo en cuenta este atributo.","required":false,"in":"body","ref":"","_id":"57488481db76422200d95881"},{"name":"invoicePreferences","type":"string","default":"","desc":"Objeto que contiene las preferencias de facturación de la empresa. Contiene los siguientes atributos: `defaultAnotation` : Notas por defecto que la empresa tiene configuradas en la aplicación. `defaultTermsAndConditions`: Términos y condiciones por defecto que tiene configuradas la empresa.","required":false,"in":"body","ref":"","_id":"57488481db76422200d95880"},{"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":"5bedd6849b49e8004462dcb1"},{"name":"settings","type":"object","default":"","desc":"Objeto compuesto por las configuraciones de la compañía. Contiene el atributo `electronicInvoicing`, el cuál se envía en true para activar facturación electrónica. Para Colombia es posible indicar la versión de facturación electrónica, `electronicInvoicingVersion` valores: `2.0` ó `2.1`.","required":false,"in":"body","ref":"","_id":"5beddc7bde0ab00430c2fbd3"},{"name":"settings (Mexico)","type":"object","default":"","desc":"Para México se especifica el objeto compuesto por las configuraciones de la compañía. Contiene el atributo `electronicInvoicing`, el cuál se envía en true para activar facturación electrónica. Con el atributo `passwordKey` se envia la contraseña de la llave privada que se envia en el atributo `stampFiles`.","required":false,"in":"body","ref":"","_id":"5f298b71212fd5001877202f"},{"name":"settings (Costa Rica)","type":"object","default":"","desc":"Para Costa Rica se especifica el objeto compuesto por las configuraciones de la compañía. Contiene el atributo `electronicInvoicing`, el cuál se envía en true para activar facturación electrónica. Con el atributo `passwordKey` se envia la contraseña de la llave privada que se envia en el atributo `stampFiles`. En el atributo `governmentEntityUser` se envia el usuario para generar comprobantes electrónicos y con `governmentEntityPassword` la contraseña.","required":false,"in":"body","ref":"","_id":"5f298b71212fd5001877202e"},{"name":"settings (Chile)","type":"object","default":"","desc":"Para Chile se especifica el objeto compuesto por las configuraciones de la compañía. Contiene el atributo `electronicInvoicing`, el cuál se envía en true para activar facturación electrónica. Con el atributo `passwordKey` se envia la contraseña de la llave que se envia en el atributo `stampFiles` y con `resolution` se envia el numero y fecha de la resolución.","required":false,"in":"body","ref":"","_id":"5f298b71212fd50018772023"},{"name":"countryCode","type":"string","default":"","desc":"Para Versión Internacional, indica el código de país de la compañía","required":false,"in":"body","ref":"","_id":"5c7576bda6253e002691d73c"},{"name":"fiscalResponsabilities","type":"array_int","default":"","desc":"Para Colombia, indica las responsabilidades fiscales de la empresa. Si el atributo `settings.electronicInvoicing` es `true` y `settings.electronicInvoicingVersion` es `2.1` este atributo se vuelve obligatorio. Consulta el catálogo de parámetros correspondiente a cada país haciendo clic [aquí](https://developer.alegra.com/docs/colombia).","required":false,"in":"body","ref":"","_id":"5dd6ce156a3e0a002bed23ab"},{"name":"setTest","type":"array_mixed","default":"","desc":"Para Colombia, objeto compuesto por las configuración del set de pruebas para facturación electrónica 2.1. Contiene el atributo `id` en el cual se envía el identificador del set de pruebas. Si el atributo `settings.electronicInvoicing` es `true` y `settings.electronicInvoicingVersion` es `2.1` este atributo se vuelve obligatorio.","required":false,"in":"body","ref":"","_id":"5dd6ce156a3e0a002bed23aa"},{"name":"giro","type":"string","default":"","desc":"Para Chile, indica el giro de negocio de la compañía. Parámetro obligatorio si se tiene facturación electrónica activa.","required":false,"in":"body","ref":"","_id":"5e5fdd580a1d0b005a07c0d0"},{"name":"economicActivities","type":"array_object","default":"","desc":"Para Chile, array que indica las actividades económicas de la compañía, cada elemento es un objeto que puede contener: `id(string)` código de la actividad, `value(string)` nombre de la actividad y `main(boolean)` actividad principal (obligatorio declarar una actividad principal). Parámetro obligatorio si se tiene facturación electrónica activa.","required":false,"in":"body","ref":"","_id":"5e5fdd580a1d0b005a07c0cf"},{"name":"economicActivity (Costa Rica)","type":"int","default":"","desc":"Para Costa Rica, describe el código de la actividad economica de la compañia.","required":false,"in":"body","ref":"","_id":"5ec410ad5fe2ef02b50c35c6"},{"name":"stampReceptionEmail","type":"string","default":"","desc":"Para Colombia, Mexico y Costa Rica, describe el correo electrónico para recibir comprobantes electrónicos.","required":false,"in":"body","ref":"","_id":"5f298b71212fd50018772027"},{"name":"stampFiles (México)","type":"object","default":"","desc":"Para Mexico, en el atributo `certificate` se especifica el certificado CSD (.cer) y con el atributo `privateKey` se envia la llave privada (.key), estos atributos son obligatorios para activar facturación electrónica y se deben enviar en formato base64.","required":false,"in":"body","ref":"","_id":"5f298b71212fd50018772026"},{"name":"stampFiles (Costa Rica)","type":"object","default":"","desc":"Para Costa Rica, en el atributo `certificate` se especifica la llave de producción (.p12), este atributo es obligatorio para activar facturación electrónica y se deben enviar en formato base64.","required":false,"in":"body","ref":"","_id":"5f298b71212fd50018772025"},{"name":"stampFiles (Chile)","type":"object","default":"","desc":"Para Chile, en el atributo `certificate` se especifica el certificado electrónico (.pfx), este atributo es obligatorio para activar facturación electrónica y se deben enviar en formato base64.","required":false,"in":"body","ref":"","_id":"5f298b71212fd50018772024"},{"name":"decimalSeparator","type":"string","default":"","desc":"Indica el separador decimal asociado a los documentos de la empresa, los valores posibles son `.` y `,`.","required":false,"in":"body","ref":"","_id":"5f64c93f5e2d5c003220e114"}],"results":{"codes":[]},"settings":""},"next":{"description":"","pages":[]},"title":"Editar empresa","type":"endpoint","slug":"editar-empresa","excerpt":"Endpoint para editar la información de una empresa","body":"[block:callout]\n{\n  \"type\": \"warning\",\n  \"title\": \"Únicamente se modifican los atributos que se envían en el request, los otros atributos del objeto que no se envían quedan intactos.\"\n}\n[/block]\nPor ejemplo para editar el nombre de la empresa se debe enviar el siguiente JSON:\n\n```JSON\n{\n\"name\" : \"Nuevo nombre  de mi empresa\"\n}\n```\n\n\nPara eliminar algún dato de la empresa enviar el atributo en null, así:\n```JSON\n{\n\"phone\" : null\n}\n```\n\nSe retorna la empresa que se ha modificado.","updates":["574c44b4cf99610e00ef7d76"],"order":4,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"57487d77db76422200d9586c","category":{"sync":{"isSync":false,"url":""},"pages":[],"title":"Empresa","slug":"empresa","order":8,"from_sync":false,"reference":true,"_id":"56b4b3eb7bccae0d00e9a12e","version":"56abd2434e4b730d009eb10d","createdAt":"2016-02-05T14:38:35.098Z","project":"56abd2434e4b730d009eb10a","__v":0},"createdAt":"2016-05-27T17:01:43.923Z","editedParams2":true,"user":"56abd213d4432d1900eed227","githubsync":"","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","5f172282d7522c03be08713f","5f3c4814ac3e6209c38b7615","5f4fbe7281626c006887f104","5f5242887d2f8701ff580d22"],"_id":"56abd2434e4b730d009eb10d","project":"56abd2434e4b730d009eb10a","releaseDate":"2016-01-29T20:57:39.712Z","__v":43,"createdAt":"2016-01-29T20:57:39.712Z"},"__v":34,"editedParams":true,"parentDoc":null,"project":"56abd2434e4b730d009eb10a"}

putEditar empresa

Endpoint para editar la información de una empresa

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Body Params

name:
string
Nombre de la empresa. Longitud máxima permitida: 90. Para Colombia, si la compañía es de una persona natural, se debe enviar este atributo como un objeto, que contiene los atirbutos: `firstName` (obligatorio), `secondName` (opcional), `lastName` (obligatorio).
address:
object
Objeto Address que contiene la dirección de la empresa, compuesto por los atributos `address (string)` dirección y `city (string)` Ciudad.
address:
object
Para Alegra México, este objeto debe contener los atributos : `street (string)`: Calle de la empresa; `exteriorNumber (string)` : Número de exterior; `interiorNumber (string)`: Número de interior; `colony (string)`: Colonia de la empresa; `country (string, obligatorio)`: país de la empresa; `locality (string)`: localidad; `municipality (string)`: Municipio; `state (string, obligatorio)`: estado, `zipCode (number)`: código postal de la empresa.
address:
object
Para perú, el Objeto address que contiene la información de la dirección de la empresa 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 de la compañía 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 "00".
address:
string
Para Colombia, el objeto address con la información de la dirección de la compañía está compuesto por los siguientes atributos: `address (string)` Dirección, `department (string)` Departamento, `city (string)` Ciudad, `zipCode (string)` Código postal.
address:
string
Para Chile, el objeto address con la información de la dirección de la compañía está compuesto por los siguientes atributos: 'city (string)` ciudad, `region (string)` región, `commune (string)` comuna y `description (string)` otras señas.
identification:
string
Identificación de la empresa. Ej RFC, cédula, NIT, RUC, entre otros. Para la versión Alegra Perú es obligatorio el numero de identificación del RUC.
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.
email:
string
Correo electrónico de la empresa.
phone:
string
Teléfono de la empresa.
website:
string
Página web de la empresa.
decimalPrecision:
integer
Indica la precisión decimal que tiene configurada la empresa para la creación de documentos. Las facturas de venta y demás documentos que se creen se aproximan teniendo en cuenta este atributo.
invoicePreferences:
string
Objeto que contiene las preferencias de facturación de la empresa. Contiene los siguientes atributos: `defaultAnotation` : Notas por defecto que la empresa tiene configuradas en la aplicación. `defaultTermsAndConditions`: Términos y condiciones por defecto que tiene configuradas la empresa.
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.
settings:
object
Objeto compuesto por las configuraciones de la compañía. Contiene el atributo `electronicInvoicing`, el cuál se envía en true para activar facturación electrónica. Para Colombia es posible indicar la versión de facturación electrónica, `electronicInvoicingVersion` valores: `2.0` ó `2.1`.
settings:
object
Para México se especifica el objeto compuesto por las configuraciones de la compañía. Contiene el atributo `electronicInvoicing`, el cuál se envía en true para activar facturación electrónica. Con el atributo `passwordKey` se envia la contraseña de la llave privada que se envia en el atributo `stampFiles`.
settings:
object
Para Costa Rica se especifica el objeto compuesto por las configuraciones de la compañía. Contiene el atributo `electronicInvoicing`, el cuál se envía en true para activar facturación electrónica. Con el atributo `passwordKey` se envia la contraseña de la llave privada que se envia en el atributo `stampFiles`. En el atributo `governmentEntityUser` se envia el usuario para generar comprobantes electrónicos y con `governmentEntityPassword` la contraseña.
settings:
object
Para Chile se especifica el objeto compuesto por las configuraciones de la compañía. Contiene el atributo `electronicInvoicing`, el cuál se envía en true para activar facturación electrónica. Con el atributo `passwordKey` se envia la contraseña de la llave que se envia en el atributo `stampFiles` y con `resolution` se envia el numero y fecha de la resolución.
countryCode:
string
Para Versión Internacional, indica el código de país de la compañía
fiscalResponsabilities:
array of integers
Para Colombia, indica las responsabilidades fiscales de la empresa. Si el atributo `settings.electronicInvoicing` es `true` y `settings.electronicInvoicingVersion` es `2.1` este atributo se vuelve obligatorio. Consulta el catálogo de parámetros correspondiente a cada país haciendo clic [aquí](https://developer.alegra.com/docs/colombia).
setTest:
array of mixed
Para Colombia, objeto compuesto por las configuración del set de pruebas para facturación electrónica 2.1. Contiene el atributo `id` en el cual se envía el identificador del set de pruebas. Si el atributo `settings.electronicInvoicing` es `true` y `settings.electronicInvoicingVersion` es `2.1` este atributo se vuelve obligatorio.
giro:
string
Para Chile, indica el giro de negocio de la compañía. Parámetro obligatorio si se tiene facturación electrónica activa.
economicActivities:
array of objects
Para Chile, array que indica las actividades económicas de la compañía, cada elemento es un objeto que puede contener: `id(string)` código de la actividad, `value(string)` nombre de la actividad y `main(boolean)` actividad principal (obligatorio declarar una actividad principal). Parámetro obligatorio si se tiene facturación electrónica activa.
economicActivity:
integer
Para Costa Rica, describe el código de la actividad economica de la compañia.
stampReceptionEmail:
string
Para Colombia, Mexico y Costa Rica, describe el correo electrónico para recibir comprobantes electrónicos.
stampFiles:
object
Para Mexico, en el atributo `certificate` se especifica el certificado CSD (.cer) y con el atributo `privateKey` se envia la llave privada (.key), estos atributos son obligatorios para activar facturación electrónica y se deben enviar en formato base64.
stampFiles:
object
Para Costa Rica, en el atributo `certificate` se especifica la llave de producción (.p12), este atributo es obligatorio para activar facturación electrónica y se deben enviar en formato base64.
stampFiles:
object
Para Chile, en el atributo `certificate` se especifica el certificado electrónico (.pfx), este atributo es obligatorio para activar facturación electrónica y se deben enviar en formato base64.
decimalSeparator:
string
Indica el separador decimal asociado a los documentos de la empresa, los valores posibles son `.` y `,`.

Documentation

[block:callout] { "type": "warning", "title": "Únicamente se modifican los atributos que se envían en el request, los otros atributos del objeto que no se envían quedan intactos." } [/block] Por ejemplo para editar el nombre de la empresa se debe enviar el siguiente JSON: ```JSON { "name" : "Nuevo nombre de mi empresa" } ``` Para eliminar algún dato de la empresa enviar el atributo en null, así: ```JSON { "phone" : null } ``` Se retorna la empresa que se ha modificado.

User Information

Try It Out

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