Zum Hauptinhalt springen
Colombia DIAN Electronic Equivalent POS Document Validator

Colombia DIAN Electronic Equivalent POS Document Validator: Inbetriebnahme

Um Colombia DIAN Electronic Equivalent POS Document Validator in Betrieb zu nehmen, installieren Sie die Version, die zu Ihrem Odoo passt, und tragen im Unternehmensformular die NIT und den API-Schlüssel ein. Prüfen Sie dann, ob Ihre Dokumente stimmen (Gesamtbetrag gleich Zwischensumme plus Steuer, keine negativen Beträge und kein Datum in der Zukunft), und starten Sie die Stapelvalidierung. In der ersten Woche kontrollieren Sie die Dokumente in Invalid und Validation Error sowie die Validierungsergebnisse in Fail oder Warning.

FlexigoTech · Verantwortlich: Víctor Gómez · Aktualisiert am 4. November 2026

Das Wichtigste

Versionen
Odoo 17, 18, 19 und 20
Geprüft
im Quellcode des Moduls, Version 20.0 · in den Quellen am Ende
Lesezeit
5 Min.

Vor der Installation: Version, Preis und Ansichten

Das Modul ist in Odoo Apps für 17.0, 18.0, 19.0 und 20.0 veröffentlicht, mit einem eigenen Eintrag pro Version. In Odoo Apps kostet es 9 € pro Odoo-Version (17.0, 18.0, 19.0 und 20.0), als Einmalzahlung zzgl. MwSt.; der lokale Service von FlexigoTech kostet 29 €/Monat oder 290 €/Jahr zzgl. MwSt. (Pro: 58 €/Monat oder 580 €/Jahr). Ohne Abonnement oder bei pausiertem Service entfällt, was das Abonnement bietet, Ihre Daten bleiben aber in Ihrem Odoo. Wenn Sie noch abwägen, ob das Modul zu Ihnen passt, beginnen Sie mit was es abdeckt und was Sie vor der Installation brauchen.

Nach der Installation arbeiten Sie bei der Einrichtung mit diesen Ansichten:

Rundgang durch die Liste der DIAN-Dokumente mit ihrem Validierungsstatus, die Liste der Validierungsregeln, den Assistenten für die Stapelvalidierung und das Unternehmensformular
Von der Dokumentenliste zum Unternehmensformular, über die Regeln und den Assistenten für die Stapelvalidierung

Die Dokumentenliste zeigt Nummer, Unternehmen, Typ, Datum, Kunde, Gesamtbetrag und Validierungsstatus. Die Liste der Validierungsregeln erscheint mit der Spalte Rule Name und der Schaltfläche Nuevo.

Das Unternehmensformular: als Erstes ausfüllen

Das Unternehmensformular hat vier Bereiche: Informationen, Validierungseinstellungen, API-Konfiguration und Audit. Direkt nach der Installation sind NIT und API-Schlüssel leer, das Timeout hat bereits einen Wert.

Unternehmensformular von My Company in DIAN Validation mit den Bereichen Informationen, Validierungseinstellungen, API-Konfiguration und Audit, NIT und API-Schlüssel leer
Das Unternehmensformular direkt nach der Installation, noch ohne Daten: NIT und API-Schlüssel sind leer

Zur NIT gibt es eine Prüfung, die Sie vor der Eingabe kennen sollten: Das Modul lehnt eine NIT ab, die nicht genau 11 Ziffern hat, mit der Meldung NIT must be exactly 11 digits. Erscheint sie, zählen Sie die eingegebenen Ziffern nach.

Schritte bis zum laufenden Betrieb

In dieser Reihenfolge gehen Sie vor, von der Installation bis zur ersten Validierung:

  1. Installieren Sie das Modul aus dem Eintrag für die Version, die Ihr Odoo verwendet (17.0, 18.0, 19.0 oder 20.0).
  1. Öffnen Sie das Unternehmensformular und tragen Sie die NIT mit genau 11 Ziffern ein.
  1. Tragen Sie im Bereich API-Konfiguration den API-Schlüssel ein, der nach der Installation leer ist.
  1. Gehen Sie die Validierungseinstellungen und das Timeout durch und speichern Sie.
  1. Prüfen Sie vor der Validierung Ihre Dokumente: Der Gesamtbetrag muss Zwischensumme plus Steuer sein, kein Betrag darf negativ sein und das Dokumentdatum darf nicht nach dem heutigen Tag liegen.
  1. Öffnen Sie den Assistenten Batch Document Validation, wählen Sie Company, Date From und Date To, stellen Sie die Filter für Typ und Status ein und klicken Sie auf Start Validation. Der Assistent hat außerdem die Schaltfläche Cancel.
  1. Kehren Sie zur Dokumentenliste zurück und sehen Sie sich den Validierungsstatus jedes Dokuments an.
  1. Öffnen Sie die Liste Validation Reports.
Modaler Assistent Batch Document Validation mit Company, Date From, Date To, dem Zähler der zu validierenden Dokumente auf null, den Filtern All Types und Draft sowie den Schaltflächen Start Validation und Cancel
Der Assistent für die Stapelvalidierung in einer Installation ohne Datensätze: Der Zähler der zu validierenden Dokumente steht auf null

Validierungsstatus und Ergebnisse

Das Feld validation_status, also der Validierungsstatus in der Dokumentenliste, kann diese Werte annehmen (Code und Bezeichnung so, wie das Modul sie definiert):

  • draft: Draft
  • pending: Pending Validation
  • validated: Validated
  • invalid: Invalid
  • error: Validation Error

Daneben gibt es result_status mit drei Werten: pass (Pass), fail (Fail) und warning (Warning).

Das Modul hat außerdem eine zweite Auswahlliste für validation_status mit kürzeren Bezeichnungen und einer zusätzlichen Option: all (All Statuses), draft (Draft), pending (Pending), validated (Validated), invalid (Invalid) und error (Error). Die Codes stimmen mit denen der ersten Liste überein; nur die Bezeichnung ändert sich. pending kann also als Pending oder Pending Validation erscheinen und error als Error oder Validation Error.

Achten Sie auf den Code, nicht nur auf die Bezeichnung: error wird je nach Liste als Validation Error oder als Error angezeigt.

Fehler bei der Einrichtung und wie Sie sie beheben

Dies sind die Validierungsmeldungen des Moduls und was Sie jeweils tun:

  • Total amount ({document.total}) does not match subtotal ({document.subtotal}) + tax ({document.tax_amount}). Expected: {expected_total}. Der Gesamtbetrag ist nicht die Summe aus Zwischensumme und Steuer. Die Meldung nennt den erwarteten Gesamtbetrag: Korrigieren Sie Gesamtbetrag, Zwischensumme oder Steuer, bis alles stimmt.
  • Total amount cannot be negative. Prüfen Sie den Gesamtbetrag des Dokuments und setzen Sie ihn auf einen positiven Wert oder null.
  • Subtotal cannot be negative. Dasselbe für die Zwischensumme.
  • Tax amount cannot be negative. Dasselbe für den Steuerbetrag.
  • Document date cannot be in the future. Ändern Sie das Dokumentdatum auf heute oder einen früheren Tag.
  • NIT must be exactly 11 digits. Korrigieren Sie die NIT, sodass sie genau 11 Ziffern hat.

Was Sie in der ersten Woche prüfen

Wenn das Unternehmensformular ausgefüllt und eine erste Stapelvalidierung gelaufen ist, nehmen Sie sich täglich ein paar Minuten dafür:

  • Dokumente in Invalid oder Validation Error: Öffnen Sie sie und prüfen Sie, ob eine der obigen Meldungen das Problem erklärt.
  • Validierungsergebnisse mit result_status auf Fail oder Warning: Prüfen Sie sie, bevor Sie die betroffenen Dokumente als in Ordnung betrachten.
  • Dokumente, die noch in Draft oder Pending Validation stehen: Suchen Sie sie in der Liste und entscheiden Sie, ob sie in die nächste Stapelvalidierung gehören.
  • Die Liste Validation Reports: Prüfen Sie Unternehmen, Typ, Daten und wer den jeweiligen Bericht erstellt hat.
Liste Validation Reports im Modul DIAN Validation mit fünf Berichten und Spalten für Unternehmen, Typ, Daten und erstellt von, mit Summen auf null
Die Liste der Validierungsberichte in einer Installation ohne Dokumente: Die Summen stehen in allen Zeilen auf null

Wie FlexigoTech Sie unterstützt

Details zum Modul finden Sie auf der Modulseite auf flexigotech.com oder in seinem Eintrag in Odoo Apps. Mit dem Abonnement ist das Modul für neue Odoo-Versionen enthalten, wenn Sie es auf flexigotech.com gekauft haben; im Odoo App Store wird jede Odoo-Version dort gekauft. Wenn Sie außerdem eine Einführung von Odoo 17, 18, 19 oder 20 brauchen oder eine individuelle Integration, die diesen Validator mit Ihren übrigen Prozessen verbindet, übernimmt FlexigoTech die Einführung und entwickelt Konnektoren und individuelle Integrationen.

Weiterlesen

So funktioniert der Validator für DIAN-POS-Äquivalenzdokumente in Odoo internMenüs, stündliche geplante Aktion, Modelle und der Weg eines Dokuments im Colombia DIAN Electronic Equivalent POS Document Validator für Odoo.Colombia DIAN Electronic Equivalent POS Document Validator: passt er und in welcher Odoo-Version?Was das DIAN-Modul für äquivalente POS-Dokumente in Odoo 17 bis 20 prüft, was die Doku offenlässt, was Sie vorbereiten sollten und wie Sie es testen.So funktioniert Argentina ARCA Supplier Invoice Validation in Odoo im DetailGlossar der Menüs, geplanten Aktionen und Daten des Moduls Argentina ARCA Supplier Invoice Validation and Withholding Management für Odoo.
Geprüft im Quellcode des Moduls (Version 20.0) und in den verlinkten Quellen

Quellen