sat_catalogos

Catálogos oficiales del SAT para CFDI 4.0, generados automáticamente desde catCFDI.xsd y catCFDI.xlsx.

Estos archivos son auto-generados por sat_catalogos_codegen. NO EDITAR a mano.

Catálogos disponibles

SimpleType SAT	Módulo Elixir	Variante	Átomos	Extras
`c_FormaPago`	`Sat.Catalogos.FormaPago`	`:with_atoms`	Sí
`c_MetodoPago`	`Sat.Catalogos.MetodoPago`	`:with_atoms`	Sí
`c_TipoDeComprobante`	`Sat.Catalogos.TipoComprobante`	`:with_atoms`	Sí
`c_Impuesto`	`Sat.Catalogos.Impuesto`	`:with_atoms`	Sí
`c_UsoCFDI`	`Sat.Catalogos.UsoCFDI`	`:with_atoms`	Sí
`c_Exportacion`	`Sat.Catalogos.Exportacion`	`:with_atoms`	Sí
`c_Moneda`	`Sat.Catalogos.Moneda`	`:with_atoms`	Sí
`c_RegimenFiscal`	`Sat.Catalogos.RegimenFiscal`	`:regimen_fiscal`	No	`persona_fisica`, `persona_moral`, `inicio_vigencia`, `fin_vigencia`
`c_Periodicidad`	`Sat.Catalogos.Periodicidad`	`:strings_only`	No
`c_Meses`	`Sat.Catalogos.Meses`	`:strings_only`	No
`c_TipoRelacion`	`Sat.Catalogos.TipoRelacion`	`:strings_only`	No
`c_ObjetoImp`	`Sat.Catalogos.ObjetoImp`	`:strings_only`	No
`c_TipoFactor`	`Sat.Catalogos.TipoFactor`	`:strings_only`	No
`c_Pais`	`Sat.Catalogos.Pais`	`:strings_only`	No
`c_Estado`	`Sat.Catalogos.Estado`	`:strings_only`	No

API

Catálogos con átomos (`FormaPago`, `MetodoPago`, `TipoComprobante`, `Impuesto`, `UsoCFDI`, `Exportacion`, `Moneda`)

# Todos los registros
list/0  :: [%{value: atom(), code: String.t(), label: String.t(), deprecated: boolean()}]

# ¿Existe este código SAT?
valid?/1 :: (String.t()) -> boolean()   # solo acepta string; atom/integer → false

# Átomo → código SAT string
value/1  :: (atom()) -> String.t() | nil

# Código SAT string → mapa completo
from_code/1 :: (String.t()) -> {:ok, %{value: atom(), code: String.t(), label: String.t(), deprecated: boolean()}} | :error

Catálogos string-only (`RegimenFiscal`, `Periodicidad`, `Meses`, `TipoRelacion`, `ObjetoImp`, `TipoFactor`, `Pais`, `Estado`)

# Todos los registros
list/0  :: [%{value: String.t(), label: String.t(), deprecated: boolean(), ...extras}]

# ¿Existe este código SAT?
valid?/1 :: (String.t()) -> boolean()   # no hay value/1 en estos módulos

# Código SAT string → mapa completo
from_code/1 :: (String.t()) -> {:ok, %{value: String.t(), label: String.t(), deprecated: boolean(), ...extras}} | :error

Nota: los catálogos string-only no exponen value/1. El campo :value de cada entrada es directamente el código SAT como string.

Ejemplos

alias Sat.Catalogos.{FormaPago, MetodoPago, RegimenFiscal, Pais, TipoFactor}

# Átomo → código SAT
FormaPago.value(:efectivo)
# => "01"

# Código SAT → mapa completo
FormaPago.from_code("01")
# => {:ok, %{value: :efectivo, code: "01", label: "Efectivo", deprecated: false}}

# Validación por código string
FormaPago.valid?("01")   # => true
FormaPago.valid?("ZZ")   # => false
FormaPago.valid?(:efectivo)  # => false (solo acepta string)

# MetodoPago (atom-bearing)
MetodoPago.from_code("PUE")
# => {:ok, %{value: :pago_en_una_exhibicion, code: "PUE", label: "Pago en una sola exhibición", deprecated: false}}

# RegimenFiscal (string-only con extras)
RegimenFiscal.from_code("601")
# => {:ok, %{value: "601", label: "General de Ley Personas Morales",
#            persona_fisica: false, persona_moral: true,
#            inicio_vigencia: ~D[2022-01-01], fin_vigencia: nil, deprecated: false}}

RegimenFiscal.valid?("626")  # RESICO => true
RegimenFiscal.valid?(601)    # integer => false

# TipoFactor (string-only; el código ES el valor)
TipoFactor.valid?("Tasa")   # => true
TipoFactor.from_code("Tasa")
# => {:ok, %{value: "Tasa", label: "Tasa", deprecated: false}}

# Pais
Pais.valid?("MEX")  # => true
Pais.from_code("MEX")
# => {:ok, %{value: "MEX", label: "México", deprecated: false}}

Campos en entradas deprecadas

Las entradas deprecadas siguen siendo accesibles y retornan deprecated: true. Esto permite validar CFDIs históricos. Para filtrar solo activos:

FormaPago.list() |> Enum.reject(& &1.deprecated)