Tipos de compañías

Antes de iniciar, es importante tener en cuenta que existen dos tipos de compañías en la API:

• Principal (main)
• Asociada (associated)

Cuando se genera un usuario en la API, y junto a este su correspondiente token de acceso, dicho usuario puede crear cualquiera de estos dos tipos de compañías.

Por un lado, podemos crear la compañía de tipo principal, que puede ser o no emisora electrónica en la API. La única restricción existente es que un usuario no puede tener más de una compañía principal.

Por el otro, podemos crear compañías asociadas y para este caso no hay límite de creación, es decir, un usuario puede tener muchas compañías de tipo asociada.

Esto resulta útil cuando la compañía principal actúa como consumidora de la API, emitiendo a través de Alanube, pero al mismo tiempo, ejerce como revendedora del servicio y desea emitir a nombre de las diferentes empresas o compañía de sus clientes.

Solicitud para crear compañía

Para llevar a cabo la creación de una compañía, es necesario utilizar el siguiente endpoint y proporcionar cada uno de los parámetros requeridos. Un campo importante a considerar es el codigo de seguridad o qr, aunque no es un requisito estricto al momento de crear la compañía, se debe ingresar para emitir documentos en su nombre. Puede obtener más información sobre esto en este articulo.

Los certificados de signature y authentication que son otorgados por la DGI, se deben transmitir codificados en base64, debido a que la API acepta la información en formato texto. Para convertirlos se pueden usar herramientas online (codificadores de base64) o comandos en linux, como por ejemplo:

base64 -w 0 -i [path/to/certificate] > [path/to/outputfile]

Este comando generará un archivo con el contenido que debe ser proporcionado en el campo de [content] de cada certificado.

Después de realizada la petición a la API automáticamente se envía la solicitud de afiliación ante el sistema de la DGI, como mencionamos en este artículo.

¿Cómo le indico a la API con qué compañía quiero emitir o hacer consultas?

Para esto los distintos endpoints aceptan un parámetro opcional que es el idCompany.

Cuando el parámetro idCompany no está presente, la API interpreta que se tiene la intención de emitir a nombre de la compañía principal, la cual al ser una sola por usuario, podemos identificarla por el token del mismo, de ahí a que se dice que este tipo de compañía es la asociada al token.

Cuando el parámetro idCompany está presente, la API interpreta que se tiene la intención de emitir a nombre de una de las tantas compañías asociadas, identificada precisamente con el parámetro idCompany.

¿Cómo obtengo el parámetro idCompany?

El parámetro idCompany es retornado por la API al momento de que un usuario crea una nueva compañía mediante el endpoint correspondiente. Es importante almacenar este id de compañía ya que es lo que identifica dicha compañía recién creada en la API.

Cuando generamos el token, se asocia a éste la compañía "Principal" que puede ser o no una de las empresas emisoras de documentos. Es por esto, que tenemos disponibles una serie de servicios, donde podrá gestionar aquellas compañías de tipo "Asociada", las cuales serán aquellas empresas emisoras de documentos electrónicos asociadas a su token.

¿Qué son las sucursales? ¿Son necesarias?

Las sucursales u oficinas representan entidades que almacenan información de ubicación y contacto del punto físico desde el cual se emite un documento electrónico. Estas son de caracter obligatorio, lo que significa que es esencial tener al menos una oficina creada al emitir cualquier comprobante. Esto se debe a que esta información es requerida por la DGI en cada emisión. Puede utilizar el siguiente endpoint para crear una oficina.

Así como las compañías están asociadas a un usuario identificado con el token, las oficinas están vinculadas a una compañía en particular. En consecuencia, es posbile tener una única oficina principal y múltiples asociadas a una misma compañía. La diferencia entre los dos tipos, es similar al de compañía principal-asociada detallado en secciones anteriores, en caso de no especificar un idOffice en la emisión del documento, se utilizará la oficina principal asociada a la compañía. Para las oficinas asociadas, es fundamental especificar el idOffice para garantizar que se utilicen los datos correspondientes a esa oficina en particular.