Catálogo de parámetros para Colombia
Tipos de identificación
A continuación se detallan los tipos de identificación disponibles para Colombia
| Id | Descripción |
|---|---|
| RC | Registro civil |
| TI | Tarjeta de identidad |
| CC | Cédula de ciudadanía |
| TE | Tarjeta de extranjería |
| CE | Cédula de extranjería |
| NIT | Número de identificación tributaria |
| PP | Pasaporte |
| PEP | Permiso especial de permanencia |
| DIE | Documento de identificación extranjero |
| NUIP | NUIP |
| FOREIGN_NIT | NIT de otro país |
Regímenes
A continuación se detallan los régimenes disponibles para Colombia.
| Id | Descripción | Obervaciones |
|---|---|---|
| SIMPLIFIED_REGIME | No responsable del IVA (Régimen simplificado) | Aplica tanto para cliente como para la empres |
| COMMON_REGIME | Responsable del IVA (Régimen común)a | Aplica tanto para cliente como para la empresa. |
| NOT_REPONSIBLE_FOR_CONSUMPTION | No responsable de consumo (Régimen simplificado del INC)a | Aplica únicamente para empresa. |
| SPECIAL_REGIME | Régimen especial | Aplica únicamente para empresa. |
| NATIONAL_CONSUMPTION_TAX | Impuesto Nacional al Consumo | Aplica tanto para cliente como para la empresa. |
| INC_IVA_RESPONSIBLE | Responsable de IVA e INC | Aplica tanto para cliente como para la empresa. |
Tipos de Personas
A continuación se detallan los tipos de personas disponibles para Colombia.
| Id | Descripción |
|---|---|
| LEGAL_ENTITY | Persona jurídica |
| PERSON_ENTITY | Persona naturala |
Estados legales
A continuación se detallan los estados legales de un comprobante expedido ante la DIAN.
| Id | Descripción |
|---|---|
| ACCEPTED | Comprobante entregado a la DIAN |
| REJECTED | Comprobante no entregado por falla |
| PENDING | Comprobante en proceso de autorización ante la DIAN |
Tipos de factura
A continuación se detallan los tipos de factura de un comprobante expedido ante la Dian. (Facturación electrónica versión 2.1)
| Id | Descripción |
|---|---|
| NATIONAL | Factura nacional |
| EXPORT | Factura de exportación |
Tipos de Nota Crédito
| Id | Descripción |
|---|---|
| PARTIALL_DEVOLUTION | Devolución de parte de los bienes; no aceptación de partes del servicio |
| VOID_ELECTRONIC_INVOICE | Anulación de factura electrónica |
| REDUCTION_DISCOUNT_PARTIAL_TOTAL | Rebaja o descuento parcial o total |
| PRICE_ADJUSTMENT | Ajuste de precio |
| OTHER | Otros |
Tipos de operación en Nota Crédito
| Id | Descripción |
|---|---|
| REFERENCE_TO_ELECTRONIC_INVOICE | Se hace referencia a la factura electronica |
| NO_REFERENCE_TO_ELECTRONIC_INVOICE | No se hace referencia a la factura electronica. (Indicada si la factura tiene el evento de aceptación) |
Tipos de Nota Débito de Cliente
| Id | Descripción |
|---|---|
| PROFITS | Intereses |
| EXPENSES_RECEIVABLE | Gastos por cobrar |
| VALUE_CHANGE | Cambio del valor |
| OTHERS | Otros |
Tipos de Operación
A continuación se detallan los tipos de operación de un comprobante expedido ante la Dian.
(Facturación electrónica versión 2.1)
| Id | Descripción |
|---|---|
| STANDARD | Estándar |
| AIU_SERVICE | Servicios |
Formas de pago
A continuación se detallan las formas de pago de un comprobante expedido ante la Dian.
(Facturación electrónica versión 2.1)
| Id | Descripción |
|---|---|
| CASH | Contado |
| CREDIT | Crédito |
Medios de pago
A continuación se detallan los medios de pago de un comprobante expedido ante la Dian.
(Facturación electrónica versión 2.1)
| Id | Descripción |
|---|---|
| INSTRUMENT_NOT_DEFINED | Instrumento no definido |
| CASH | Efectivo |
| DEBIT_TRANSFER | Débito ACH |
| BANK_DEPOSIT | Consignación bancaria |
| ACH_CREDIT | Crédito ACH |
| ACH_DEBIT | Débito ACH |
| REVERSION_ACH_DEBIT | Reversión débito de demanda ACH |
| REVERSION_ACH_CREDIT | Reversión crédito de demanda ACH |
| CREDIT_ACH_DEMAND | Crédito de demanda ACH |
| DEBIT_ACH_DEMAND | Débito de demanda ACH |
| NATIONAL_CLEARING | Clearing nacional o regional |
| REVERSION_CREDIT_SAVING | Reversión crédito ahorro |
| REVERSION_DEBIT_SAVING | Reversión débito ahorro |
| CREDIT_SAVING | Crédito ahorro |
| DEBIT_SAVING | Débito ahorro |
| BOOKENTRY_CREDIT | Bookentry crédito |
| BOOKENTRY_DEBIT | Bookentry débito |
| CTP_CREDIT | Crédito pago negocio corporativo (CTP) |
| CHECK | Cheque |
| BANK_PROYECT | Proyecto bancario |
| BANK_PROYECT_CERTIFIED | Proyecto bancario certificado |
| EXCHANGE_RATE_PENDING_ACEPT | Nota cambiaria esperando aceptación |
| CERTIFIED_CHECK | Cheque certificado |
| LOCAL_CHECK | Cheque local |
| CTP_DEBIT | Débito Pago Negocio Corporativo (CTP) |
| CTX_CREDIT | Crédito Negocio Intercambio Corporativo (CTX) |
| CTX_DEBIT | Débito Negocio Intercambio Corporativo (CTX) |
| CREDIT_TRANSFER | Transferecia crédito |
| PPD_PAY | Pago y depósito pre acordado (PPD) |
| CTP_CREDIT_SAVING | Pago negocio corporativo ahorros crédito (CTP) |
| CTP_DEBIT_SAVING | Pago negocio corporativo ahorros débito (CTP) |
| EXCHANGE_RATE | Nota cambiaria |
| CREDIT_TRANSFER_BANK | Transferencia crédito bancario |
| DEBIT_TRANSFER_INTERBANK | Transferencia débito interbancario |
| DEBIT_TRANSFER_BANK | Transferencia débito bancaria |
| CREDIT_CARD | Tarjeta crédito |
| DEBIT_CARD | Tarjeta débito |
| POSTTURN | Postgiro |
| URGENT_BUSINESS_PAYMENT | Pago comercial urgente |
| URGENT_CASH_PAYMENT | Pago tesorería urgente |
| PROMISING_NOTE | Nota promisoria |
| PROMISING_NOTE_SIGNED_PROVIDER | Nota promisoria firmada por el acreedor |
| PROMISING_NOTE_SIGNED_PROVIDER_BANK | Nota promisoria firmada por el acreedor, avalada por el banco |
| PROMISING_NOTE_SIGNED_PROVIDER_THIRD | Nota promisoria firmada por el acreedor, avalada por un tercero |
| PROMISING_NOTE_SIGNED_BANK | Nota promisoria firmada por el bancos |
| PROMISING_NOTE_SIGNED_BANK_ENDORSED_BANK | Nota promisoria firmada por un banco avalada por otro banco |
| PROMISING_NOTE_SIGNED | Nota promisoria firmada |
| PROMISING_NOTE_SIGNED_THIRD | Nota promisoria firmada por un tercero avalada por un banco |
| WITHDRAWAL_NOTE_CREDITOR | Retiro de nota por el acreedor |
| BONDS | Bonos |
| VOUCHERS | Vales |
| WITHDRAWAL_NOTE_CREDITOR_BANK | Retiro de nota por el acreedor sobre un banco |
| WITHDRAWAL_NOTE_CREDITOR_ENDORSED_BANK | Retiro de nota por el acreedor, avalada por otro banco |
| WITHDRAWAL_NOTE_CREDITOR_BANK_ENDORSED_THIRD | Retiro de nota por el acreedor, sobre un banco avalada por un tercero |
| WITHDRAWAL_NOTE_CREDITOR_ENDORSED_THIRD | Retiro de una nota por el acreedor sobre un tercero |
| WITHDRAWAL_NOTE_CREDITOR_THIRD_PARTY | Retiro de una nota por el acreedor sobre un tercero avalada por un banco |
| TRANSFERABLE_BANK_NOTE | Nota bancaria transferible |
| TRANSFERABLE_LOCAL_CHECK | Cheque local transferible |
| REFERENCED_TURN | Giro referenciado |
| URGENT_TURN | Giro urgente |
| OPEN_FORMAT_TWIST | Giro formato abierto |
| PAYMENT_METHOD_REQUESTED_NOT_USED | Método de pago solicitado no usado |
| CLEARING_PARTNERS | Clearing entre partners |
| CCD_CREDIT | Desembolso Crédito (CCD)s |
| CCD_DEBIT | Desembolso (CCD) débito |
| BANK_CHECK | Cheque bancario de gerencia |
| CDD_CREDIT | Desembolso Crédito plus (CCD+)s |
| CDD_CASH | Desembolso Débito plus (CCD+) |
| CCD_CASH_CREDIT | Desembolso Crédito (CCD) |
| CCD_CASH_DEBIT | Desembolso Débito (CCD) |
| CTX_CREDIT_DEAL | Crédito Intercambio Corporativo (CTX) |
| CTX_DEBIT_DEAL | Débito Intercambio Corporativo (CTX) |
| CCD_CREDIT_PLUS | Desembolso Crédito plus (CCD+) |
| CCD_DEBIT_PLUS | Desembolso Débito plus (CCD+) |
| FRENCH_BANKING_STANDARD_TELEX | Telex estándar bancario |
| MUTUAL_AGREEMENT | Otro |
Estado de emisión (emission_status)
A continuación, se detallan los posibles valores para estados de emisión de documentos electrónicos.
| Value | Descripción |
|---|---|
| PENDING | Para documentos electrónicos que no se han emitido. |
| STAMPED_AND_WAITING_RESPONSE | Para documentos electrónicos que fueron enviados pero aun no se obtiene respuesta por parte de la DIAN |
| STAMPED_AND_ACCEPTED | Para documentos electrónicos que fueron emitidos y aceptados. |
| STAMPED_AND_REJECTED | Para documentos electrónicos que fueron emitidos y rechazados. |
| STAMPED_AND_ACCEPTED_WITH_OBSERVATIONS | Para documento electrónicos que fueron emitidos y aceptados con observaciones. |
Responsabilidades fiscales
A continuación se detallan las responsabilidades fiscales disponibles para una compañía en Colombia. (Facturación electrónica versión 2.1)
| id | Descripción |
|---|---|
| 5 | Gran contribuyente |
| 7 | Autorretenedor |
| 12 | Agente de retención en el impuesto sobre las ventas |
| 114 | Régimen simple de tributación |
Condiciones de entrega
A continuación se detallan los términos o condiciones de entrega cuando la factura es de exportación.
| id | Descripción |
|---|---|
| CFR | Costo y flete |
| CIF | Costo, flete y seguro |
| CIP | Transporte y seguro pagados hasta |
| CPT | Transporte pagado hasta |
| DAP | Entregado en un lugar |
| DAT | Entregado en terminal |
| DDP | Entregado con pago de derechos |
| EXW | En fábrica |
| FAS | Franco al costado del buque |
| FCA | Franco transportista |
| FOB | Franco a bordo |
Unidades de medida
A continuación se detallan las unidades de medidas.
| Key | Nombre |
|---|---|
| unit | Unidad |
| service | Servicio |
| piece | Pieza |
| thousand | Millar |
| par | Par |
| npr | Número de pares |
| box | Caja |
| drum | Tambor |
| centimeter | Centímetro |
| meter | Metro |
| inch | Pulgada |
| foot | Pie |
| centimeterSquared | Centímetro cuadrado |
| meterSquared | Metro cuadrado |
| inchSquared | Pulgada cuadrada |
| mililiter | Mililitro |
| liter | Litro |
| gallon | Galón |
| gram | Gramo |
| kilogram | Kilogramo |
| ton | Tonelada |
| pound | Libra |
| administration | Administración |
| cubicMeterNet | Metro cúbico (neto) |
| cubicMeter | Metro cúbico |
| hour | Hora |
| minute | Minuto |
| day | Día |
| hectare | Hectárea |
| blister | Ampolla |
| vial | Frasco |
| package | Paquete |
| envelope | Sobre |
| jar | Tarro |
| tube | Tubo |
| decimeter | Decímetro |
| linealMeter | Metro lineal |
Departamentos y municipios
A continuación se detallan los departamentos y municipios de Colombia.
| Departamento | Municipio |
|---|---|
| Amazonas | El Encanto La Chorrera La Pedrera La Victoria Leticia Miriti - Paraná Puerto Alegría Puerto Arica Puerto Nariño Puerto Santander Tarapacá |
| Antioquia | Abejorral Abriaquí Alejandría Amagá Amalfi Andes Angelópolis Angostura Anorí Anzá Apartadó Arboletes Argelia Armenia Barbosa Bello Belmira Betania Betulia Briceño Buriticá Cáceres Caicedo Caldas Campamento Caracolí Caramanta Carepa Carolina Caucasia Cañasgordas Chigorodó Cisneros Ciudad Bolivar Cocorná Concepción Concordia Copacabana Dabeiba Don Matías Ebéjico El Bagre El Carmen de Viboral El Santuario Entrerrios Envigado Fredonia Frontino Giraldo Girardota Gómez Plata Granada Guadalupe Guarne Guatapé Heliconia Hispania Itagüí Ituango Jardín Jericó La Ceja La Estrella La Pintada La Unión Liborina Maceo Marinilla Medellín Montebello Murindó Mutatá Nariño Nechí Necoclí Olaya Peque Peñol Pueblorrico Puerto Berrío Puerto Nare Puerto Triunfo Remedios Retiro Rionegro Sabanalarga Sabaneta Salgar San Andres de Cuerquia San Carlos San Francisco San Jerónimo San José de la Montaña San Juan de Urabá San Luis San Pedro San Pedro de Urabá San Rafael San Roque Santa Bárbara Santafé de Antioquia Santa Rosa de Osos Santo Domingo San Vicente Segovia Sonsón Sopetrán Támesis Tarazá Tarso Titiribí Toledo Turbo Uramita Urrao Valdivia Valparaíso Vegachí Venecia Vigía del Fuerte Yalí Yarumal Yolombó Yondó Zaragoza |
| Arauca | Arauca Arauquita Cravo Norte Fortul Puerto Rondón Saravena Tame |
| Atlántico | Baranoa Barranquilla Campo de la Cruz Candelaria Galapa Juan de Acosta Luruaco Malambo Manatí Palmar de Varela Piojó Polonuevo Ponedera Puerto Colombia Repelón Sabanagrande Sabanalarga Santa Lucía Santo Tomás Soledad Suan Tubará Usiacurí |
| Bogotá, D.C. | Bogotá, D.C. |
| Bolívar | Achí Altos del Rosario Arenal Arjona Arroyohondo Barranco de Loba Calamar Cantagallo Cartagena de Indias Cicuco Clemencia Córdoba El Carmen de Bolívar El Guamo El Peñón Hatillo de Loba Magangué Mahates Margarita María la Baja Mompós Montecristo Morales Norosí Pinillos Regidor Río Viejo San Cristóbal San Estanislao San Fernando San Jacinto San Jacinto del Cauca San Juan Nepomuceno San Martin de Loba San Pablo Santa Catalina Santa Rosa Santa Rosa del Sur Simití Soplaviento Talaigua Nuevo Tiquisio Turbaco Turbana Villanueva Zambrano |
| Boyacá | Almeida Aquitania Arcabuco Belén Berbeo Betéitiva Boavita Boyacá Briceño Buenavista Busbanzá Caldas Campohermoso Cerinza Chinavita Chiquinquirá Chíquiza Chiscas Chita Chitaraque Chivatá Chivor Ciénega Cómbita Coper Corrales Covarachía Cubará Cucaita Cuítiva Duitama El Cocuy El Espino Firavitoba Floresta Gachantivá Gameza Garagoa Guacamayas Guateque Guayatá Güicán Iza Jenesano Jericó Labranzagrande La Capilla La Uvita La Victoria Macanal Maripí Miraflores Mongua Monguí Moniquirá Motavita Muzo Nobsa Nuevo Colón Oicatá Otanche Pachavita Páez Paipa Pajarito Panqueba Pauna Paya Paz de Río Pesca Pisba Puerto Boyacá Quípama Ramiriquí Ráquira Rondón Saboyá Sáchica Samacá San Eduardo San José de Pare San Luis de Gaceno San Mateo San Miguel de Sema San Pablo de Borbur Santa María Santana Santa Rosa de Viterbo Santa Sofía Sativanorte Sativasur Siachoque Soatá Socha Socotá Sogamoso Somondoco Sora Soracá Sotaquirá Susacón Sutamarchán Sutatenza Tasco Tenza Tibaná Tibasosa Tinjacá Tipacoque Toca Togüí Tópaga Tota Tunja Tununguá Turmequé Tuta Tutazá Úmbita Ventaquemada Villa de Leyva Viracacha Zetaquira |
| Caldas | Aguadas Anserma Aranzazu Belalcázar Chinchiná Filadelfia La Dorada La Merced Manizales Manzanares Marmato Marquetalia Marulanda Neira Norcasia Pácora Palestina Pensilvania Riosucio Risaralda Salamina Samaná San José Supía Victoria Villamaría Viterbo |
| Caquetá | Albania Belén de los Andaquíes Cartagena del Chairá Curillo El Doncello El Paujil Florencia La Montañita Milán Morelia Puerto Rico San Jose del Fragua San Vicente del Caguán Solano Solita Valparaíso |
| Casanare | Aguazul Chameza Hato Corozal La Salina Maní Monterrey Nunchía Orocué Paz de Ariporo Pore Recetor Sabanalarga Sácama San Luis de Palenque Támara Tauramena Trinidad Villanueva Yopal |
| Cauca | Almaguer Argelia Balboa Bolivar Buenos Aires Cajibío Caldono Caloto Corinto El Tambo Florencia Guachené Guapi Inzá Jambaló La Sierra La Vega López Mercaderes Miranda Morales Padilla Páez Patía Piamonte Piendamó Popayán Puerto Tejada Puracé Rosas San Sebastián Santander de Quilichao Santa Rosa Silvia Sotará Suárez Sucre Timbío Timbiquí Toribío Totoró Villa Rica |
| Cesar | Aguachica Agustín Codazzi Astrea Becerril Bosconia Chimichagua Chiriguaná Curumaní El Copey El Paso Gamarra González La Gloria La Jagua de Ibirico La Paz Manaure Pailitas Pelaya Pueblo Bello Río de Oro San Alberto San Diego San Martín Tamalameque Valledupar |
| Chocó | Acandí Alto Baudó Atrato Bagadó Bahía Solano Bajo Baudó Belén de Bajirá Bojayá Carmen del Darién Cértegui Condoto El Cantón del San Pablo El Carmen de Atrato El Litoral del San Juan Istmina Juradó Lloró Medio Atrato Medio Baudó Medio San Juan Nóvita Nuquí Quibdó Río Iró Río Quito Riosucio San José del Palmar Sipí Tadó Unguía Unión Panamericana |
| Córdoba | Ayapel Buenavista Canalete Cereté Chimá Chinú Ciénaga de Oro Cotorra La Apartada Lorica Los Córdobas Momil Montelíbano Montería Moñitos Planeta Rica Pueblo Nuevo Puerto Escondido Puerto Libertador Purísima Sahagún San Andrés Sotavento San Antero San Bernardo del Viento San Carlos San José de Uré San Pelayo Tierralta Tuchín Valencia |
| Cundinamarca | Agua de Dios Albán Anapoima Anolaima Apulo Arbeláez Beltrán Bituima Bojacá Cabrera Cachipay Cajicá Caparrapí Cáqueza Carmen de Carupa Chaguaní Chía Chipaque Choachí Chocontá Cogua Cota Cucunubá El Colegio El Peñón El Rosal Facatativá Fómeque Fosca Funza Fúquene Fusagasugá Gachala Gachancipá Gachetá Gama Girardot Granada Guachetá Guaduas Guasca Guataquá Guatavita Guayabal de Siquima Guayabetal Gutiérrez Jerusalén Junín La Calera La Mesa La Palma La Peña La Vega Lenguazaque Machetá Madrid Manta Medina Mosquera Nariño Nemocón Nilo Nimaima Nocaima Pacho Paime Pandi Paratebueno Pasca Puerto Salgar Pulí Quebradanegra Quetame Quipile Ricaurte San Antonio del Tequendama San Bernardo San Cayetano San Francisco San Juan de Río Seco Sasaima Sesquilé Sibaté Silvania Simijaca Soacha Sopó Subachoque Suesca Supatá Susa Sutatausa Tabio Tausa Tena Tenjo Tibacuy Tibirita Tocaima Tocancipá Topaipí Ubalá Ubaque Une Útica Venecia Vergara Vianí Villa de San Diego de Ubaté Villagómez Villapinzón Villeta Viotá Yacopí Zipacón Zipaquirá |
| Guainia | Barranco Minas Cacahual Inírida La Guadalupe Mapiripana Morichal Pana Pana Puerto Colombia San Felipe |
| Guaviare | Calamar El Retorno Miraflores San José del Guaviare |
| Huila | Acevedo Agrado Aipe Algeciras Altamira Baraya Campoalegre Colombia Elías Garzón Gigante Guadalupe Hobo Íquira Isnos La Argentina La Plata Nátaga Neiva Oporapa Paicol Palermo Palestina Pital Pitalito Rivera Saladoblanco San Agustín Santa María Suaza Tarqui Tello Teruel Tesalia Timaná Villavieja Yaguará |
| La Guajira | Albania Barrancas Dibulla Distracción El Molino Fonseca Hatonuevo La Jagua del Pilar Maicao Manaure Riohacha San Juan del Cesar Uribia Urumita Villanueva |
| Magdalena | Algarrobo Aracataca Ariguaní Cerro San Antonio Chibolo Ciénaga Concordia El Banco El Piñón El Retén Fundación Guamal Nueva Granada Pedraza Pijiño del Carmen Pivijay Plato Puebloviejo Remolino Sabanas de San Ángel Salamina San Sebastián de Buenavista Santa Ana Santa Barbara de Pinto Santa Marta San Zenón Sitionuevo Tenerife Zapayán Zona Bananera |
| Meta | Acacías Barranca de Upía Cabuyaro Castilla La Nueva Cubarral Cumaral El Calvario El Castillo El Dorado Fuente de Oro Granada Guamal La Macarena Lejanías Mapiripán Mesetas Puerto Concordia Puerto Gaitán Puerto Lleras Puerto López Puerto Rico Restrepo San Carlos de Guaroa San Juan de Arama San Juanito San Martín Uribe Villavicencio Vistahermosa |
| N. de Santander | Abrego Arboledas Bochalema Bucarasica Cachirá Cácota Chinácota Chitagá Convención Cúcuta Cucutilla Durania El Carmen El Tarra El Zulia Gramalote Hacarí Herrán Labateca La Esperanza La Playa Los Patios Lourdes Mutiscua Ocaña Pamplona Pamplonita Puerto Santander Ragonvalia Salazar San Calixto San Cayetano Santiago Sardinata Silos Teorama Tibú Toledo Villa Caro Villa del Rosario |
| Nariño | Albán Aldana Ancuyá Arboleda Barbacoas Belén Buesaco Chachagüí Colón Consacá Contadero Córdoba Cuaspud Cumbal Cumbitara El Charco El Peñol El Rosario El Tablón de Gómez El Tambo Francisco Pizarro Funes Guachucal Guaitarilla Gualmatan Iles Imués Ipiales La Cruz La Florida La Llanada La Tola La Unión Leiva Linares Los Andes Magüí Mallama Mosquera Nariño Olaya Herrera Ospina Pasto Policarpa Potosí Providencia Puerres Pupiales Ricaurte Roberto Payán Samaniego San Andrés de Tumaco San Bernardo Sandoná San Lorenzo San Pablo San Pedro de Cartago Santa Bárbara Santacruz Sapuyes Taminango Tangua Túquerres Yacuanquer |
| Putumayo | Colón Leguízamo Mocoa Orito Puerto Asís Puerto Caicedo Puerto Guzmán San Francisco San Miguel Santiago Sibundoy Valle del Guamuez Villagarzón |
| Quindío | Armenia Buenavista Calarcá Circasia Córdoba Filandia Génova La Tebaida Montenegro Pijao Quimbaya Salento |
| Risaralda | Apía Balboa Belén de Umbría Dosquebradas Guática La Celia La Virginia Marsella Mistrató Pereira Pueblo Rico Quinchía Santa Rosa de Cabal Santuario |
| San Andrés | Providencia San Andrés |
| Santander | Aguada Albania Aratoca Barbosa Barichara Barrancabermeja Betulia Bolívar Bucaramanga Cabrera California Capitanejo Carcasí Cepitá Cerrito Charalá Charta Chima Chipatá Cimitarra Concepción Confines Contratación Coromoro Curití El Carmen de Chucurí El Guacamayo El Peñón El Playón Encino Enciso Florián Floridablanca Galán Gámbita Girón Guaca Guadalupe Guapotá Guavatá Güepsa Hato Jesús María Jordán La Belleza Landázuri La Paz Lebrija Los Santos Macaravita Málaga Matanza Mogotes Molagavita Ocamonte Oiba Onzaga Palmar Palmas del Socorro Páramo Piedecuesta Pinchote Puente Nacional Puerto Parra Puerto Wilches Rionegro Sabana de Torres San Andrés San Benito San Gil San Joaquín San José de Miranda San Miguel Santa Bárbara Santa Helena del Opón San Vicente de Chucurí Simacota Socorro Suaita Sucre Suratá Tona Valle de San José Vélez Vetas Villanueva Zapatoca |
| Sucre | Buenavista Caimito Chalán Colosó Corozal Coveñas El Roble Galeras Guaranda La Unión Los Palmitos Majagual Morroa Ovejas Palmito Sampués San Benito Abad San Juan de Betulia San Luis de Since San Marcos San Onofre San Pedro Santiago de Tolú Sincelejo Sucre Tolú Viejo |
| Tolima | Alpujarra Alvarado Ambalema Anzoátegui Armero Ataco Cajamarca Carmen de Apicalá Casabianca Chaparral Coello Coyaima Cunday Dolores Espinal Falan Flandes Fresno Guamo Herveo Honda Ibagué Icononzo Lérida Líbano Mariquita Melgar Murillo Natagaima Ortega Palocabildo Piedras Planadas Prado Purificación Rioblanco Roncesvalles Rovira Saldaña San Antonio San Luis Santa Isabel Suárez Valle de San Juan Venadillo Villahermosa Villarrica |
| Valle del Cauca | Alcalá Andalucía Ansermanuevo Argelia Bolívar Buenaventura Bugalagrande Caicedonia Cali Calima Candelaria Cartago Dagua El Águila El Cairo El Cerrito El Dovio Florida Ginebra Guacarí Guadalajara de Buga Jamundí La Cumbre La Unión La Victoria Obando Palmira Pradera Restrepo Riofrío Roldanillo San Pedro Sevilla Toro Trujillo Tuluá Ulloa Versalles Vijes Yotoco Yumbo Zarzal |
| Vaupés | Carurú Mitú Pacoa Papunaua Taraira Yavaraté |
| Vichada | Cumaribo La Primavera Puerto Carreño Santa Rosalía |
Eventos electrónicos
A continuación se detalla acerca de los eventos que puede contener una factura electrónica.
La estructura estandar de un evento es el siguiente:
{
"status": "Estado del evento",
"date": "Fecha del evento",
"type": "Tipo de evento"
}
Para eventos de tipo CLIENT_EMAILS se puede tener una propiedad adicional attributes
(El evento puede o no contener esta propiedad, esto se debe a que el evento puede ser antiguo y no contiene la información suficiente para dar esa información ), quedando de la siguiente forma:
{
"status": "Estado del evento",
"date": "Fecha del evento",
"type": "Tipo de evento",
"attributes": {
"typeEmail": "Tipo de correo",
"recipient": "Correo a donde se envio la información"
}
}
Tipos de eventos
A continuación se detallara los tipos de eventos.
| Tipo | Descripción |
|---|---|
| CLIENT_EMAILS | Tipo de evento que se genera cuando se envia un correo mediante API o la APP. |
| CLIENT_ACCEPTANCE | Tipo de evento que se genera mediante las respuestas electrónicas del cliente a excepción de TACITLY_ACCEPTED que es generado por el usuario. |
Estados
A continuación se detallara los estados que pueden estar dentro de la lista de eventos.
| Tipo de evento | Status | Descripción |
|---|---|---|
| CLIENT_EMAILS | SENT | El correo ha sido enviado. |
| CLIENT_EMAILS | DELIVERED | El correo ha llegado a la bandeja del cliente. |
| CLIENT_EMAILS | OPENED | El correo ha sido leido/abierto por el cliente. |
| CLIENT_EMAILS | BOUNCED | El correo ha rebotado. |
| CLIENT_EMAILS | ERROR | El correo ha tenido un error al enviarse. |
| CLIENT_ACCEPTANCE | ACKNOWLEDGMENT_DIAN | Acuse de recibo de factura electrónica de venta |
| CLIENT_ACCEPTANCE | SERVICE_CONFIRMATION | Recibo del bien o prestación del servicio. |
| CLIENT_ACCEPTANCE | ACCEPTED_DIAN | El cliente aceptó electrónicamente la factura electrónica. |
| CLIENT_ACCEPTANCE | REJECTED_DIAN | El cliente rechazó electrónicamente la factura electrónica. |
| CLIENT_ACCEPTANCE | TACITLY_ACCEPTED | El usuario espero como mínimo 3 días hábiles para aceptar tácitamente la factura electrónica despúes de que el cliente haya recibido el bien o servicio. |