Documentación Factura Electronica
1. APIs
En el modulo de API nos dirigimos a "Factura Electrónica" (pruebas o producción).
2. Método Authenticate
Este método se usa para autenticar al usuario y así poder consumir los demás métodos de Factura Electrónica. Para consumir este método de forma correcta, debemos digitar el número de documento de la compañía, tipo de documento de la compañía, el usuario y la contraseña.
3. Método CreateAquirer
Con este método se pueden crear nuevos adquirientes de ser necesario. Para consumir correctamente este método, es necesario diligenciar todos los campos con la información del nuevo adquiriente.
4. Método CreatePrefix
En este método se crean los prefijos una vez fueron solicitados a la DIAN. Para consumir este método es necesario diligenciar todos los datos requeridos de la resolución asociada al prefijo.
5. Método CreateInvoice
una vez tengamos el adquiriente y el prefijo creado, procedemos a consumir este método el cual realiza y emite la factura electrónica. Para consumir correctamente este método debemos diligenciar todos los campos requeridos con toda la información de la factura electrónica.
En el caso de que la empresa cuente con ERP, se deberán utilizar 5 métodos los cuales son.
6. Método AuthenticateERP
Este método se usa para autenticar al usuario que cuente con ERP y así poder consumir los demás métodos de Nomina Electrónica. Para consumir este método de forma correcta, se debe diligenciar el nombre del ERP, el nombre de usuario, la contraseña, el código del tipo de documento y el número del documento.
7. Método CreateCompany
este método se usa para crear la compañía que vamos a ingresar, para esto se debe diligenciar la información principal de la empresa a registrar, las credenciales que le vamos a suministrar, datos del representante legal, la ubicación fiscal de la compañía y la ubicación física de la misma
4. Video Consumo
Introduccion
El API de Factura electrónica le permite al usuario emitir facturas a un adquiriente sobre algún o algunos bienes o servicios. También tiene otras funciones como por ejemplo obtener los detalles de las facturas enviadas, consultar algún adquiriente, entre otros.
2. Emitir documento de nómina para compañías sin ERP
2.1 Método Authenticate
Para ello se tiene el siguiente Endpoint de Pruebas:
https://apim-aeu-test-apimanagement.azure-api.net/FacturaElectronicaPruebas/Authenticate2.1.1 Parametros de Entrada
| parametros | Descripción | Tipo | Obligatorio |
|---|---|---|---|
| documentNumberCompany | Número de documento del comercio | Int | si |
| documentTypeCodeCompan | Código del tipo de documento | Int | si |
| password | Contraseña del usuario | String | si |
| user | Correo electrónico del usuario asignado en el comercio | String | si |
2.2 Método CreateAquirer
Para ello se tiene el siguiente Endpoint de Pruebas:
https://apim-aeu-test-apimanagement.azure-api.net/FacturaElectronicaPruebas/CreateAcquirer2.2.1 Parametros de Entrada
| Parametros | Descripción | Tipo | Obligatorio |
|---|---|---|---|
| active | Indica si el adquirente está activo o inactivo. Sólo se pueden usar adquirentes activos Si no se envía, el valor por defecto será false, y el adquirente quedará inactivo | String | Si |
| address | Dirección del adquirente | String | No |
| active | Indica si el contacto está activo o inactivo. Sólo se pueden usar contactos activos Si no se envía, el valor por defecto será false, y el contacto quedará inactivo | String | Si |
| address | Dirección del contacto | String | No |
| cellphoneNumber | Número de celular del contacto | Int | No |
| contract | Contrato del contacto | String | No |
| documentNumber | Número de documento del contacto | Int | Si |
| documentTypeCode | Código del tipo de documento | Int | Si |
| Correo electrónico del contacto. Se pueden indicar varios, si se separan con ";" | String | Si | |
| fullName | Nombre del contacto | String | Si |
| phoneNumber | Número de teléfono del contacto | Int | No |
| position | Código de la posición del contacto (gerente, auxiliar contabilidad, etc) | String | Si |
| sendInvoice | Indica si se deben enviar los documentos al contacto (true, false) | String | Si |
| documentNumber | Número de documento del adquirente | Int | Si |
| documentTypeCode | Código del tipo de documento de identificación | Int | Si |
| address | Direccion de la localizacion fiscal del adquiriente | String | No |
| city | Código de la ciudad, si el país es Colombia Si no es colombia, poner el nombre de la ciudad. Ej: Montreal | String | No |
| city | Código de la ciudad, si el país es Colombia Si no es colombia, poner el nombre de la ciudad. Ej: Montreal | String | No |
| countryCode | Código del país, se hace requerido siempre y cuando de ingrese un valor en alguna de las propiedades de la localización (Colombia: CO) | String | No |
| postalZone | Código postal. Se puede usar 000000 como comodín | Int | No |
| state | Código del departamento. Si no es Colombia, poner el nombre del estado. Ej: Quebec | String | No |
| fiscalResponsabilities | Se digita la responsabilidad fiscal. En caso de que no cumpla con responsabilidad fiscal, digitar R-99-PN | String | Si |
| juridicalOrganizationCode | Código del tipo de persona (1 Persona Jurídica, 2 Persona Natural) | String | Si |
| active | Indica si el registro está activo o inactivo. Si no se envía, el valor por defecto será false, y el registro quedará inactivo (true, false) | String | Si |
| cityCode | Código de la ciudad, este de tener una relación directa con el código del departamento | Int | Si |
| departmentCode | Código del departamento | Int | Si |
| value | Registro mercantíl | Int | Si |
| name | Nombre del adquirente | String | Si |
| address | Dirección de la localización física | String | Si |
| city | Código de la ciudad de la ubicación física. Si el país no es Colombia, poner el nombre de la ciudad. Ej: Montreal | String | Si |
| countryCode | Código del país, se hace requerido siempre y cuando de ingrese un valor en alguna de las propiedades de la localización (Colombia: CO) | String | Si |
| postalZone | Código postal. Se puede usar 000000 como comodín | Int | Si |
| state | Código del departamento. Si no es Colombia, poner el nombre del estado. Ej: Quebec | Stringt | Si |
| regimenTypeCode | Código del tipo de régimen (48 Impuesto sobre las ventas IVA, 49 No responsable de IVA) | Int | No |
| technologicalProviderNIT | NIT del proveedor tecnológico | Int | No |
| telephone | Teléfono del adquirente | Int | No |
| tributaryDetail | Código del tipo de detalle tributario (01 IVA, 04 INC) | Int | Si |
| verificationDigit | Dígito de verificación, en caso de que sea NIT | Int | No |