Invoice Validation¶

Validation workflows for UBL invoices and schema checks.

Example¶

RustPythonC/C++

pub fn main() {
    use fatoora_core::config::{Config, EnvironmentType};
    use fatoora_core::invoice::validation::validate_xml_invoice_from_str;

    // Doc example: validate XML against the bundled schema.
    let invoice_xml_path = std::path::Path::new(env!("CARGO_MANIFEST_DIR"))
        .join("tests/fixtures/invoices/sample-simplified-invoice.xml");
    let config = Config::new(EnvironmentType::NonProduction);
    let xml = std::fs::read_to_string(&invoice_xml_path).expect("read invoice xml");
    validate_xml_invoice_from_str(&xml, &config).expect("validate invoice");
}

from fatoora.config import Config
from fatoora.validation import validate_xml_invoice_from_str

# invoice_xml_path = "path/to/invoice.xml"
config = Config()
xml = invoice_xml_path.read_text(encoding="utf-8")

result = validate_xml_invoice_from_str(config, xml)
assert result is True

#include "fatoora.h"

#include <assert.h>
#include <stdio.h>
#include <stdlib.h>

#ifndef FATOORA_DOC_INVOICE_XML
#define FATOORA_DOC_INVOICE_XML "path/to/invoice.xml"
#endif

static char *read_file(const char *path);

int main(void) {
  const char *invoice_xml_path = FATOORA_DOC_INVOICE_XML;
  char *xml_cstr = read_file(invoice_xml_path);
  struct FfiConfig *config = fatoora_config_new(FfiEnvironment_NonProduction);

  /* invoice_xml_path = "path/to/invoice.xml" */
  struct FfiResult_bool result =
      fatoora_validate_xml_invoice_from_str(config, xml_cstr);

  assert(result.value);

  // you know the drill by now
  free(xml_cstr);
  fatoora_config_free(config);
  return 0;
}

Notes¶

Validation uses the bundled UBL schema at assets/schemas/UBL2.1/xsd/maindoc/UBL-Invoice-2.1.xsd.
The environment only affects validation if you choose a different schema per environment.