@nodecfdi/cfdi-expresiones

Library to generate expressions for CFDI 4.0, CFDI 3.3, CFDI 3.2, RET 2.0 and RET 1.0

:us: The documentation of this project is in spanish as this is the natural language for intended audience.

:mexico: La documentación del proyecto está en español porque ese es el lenguaje principal de los usuarios.

Acerca de @nodecfdi/cfdi-expresiones

Esta librería contiene objetos de ayuda para crear expresiones de CFDI 3.2, CFDI 3.3, CFDI 4.0, RET 2.0 y RET 1.0 de acuerdo a la información técnica del SAT en el Anexo 20.

Librería inspirada por la versión para php https://github.com/phpcfdi/cfdi-expresiones

Estas expresiones se utilizan principalmente para dos motivos:

1. Generar el código QR de una representación impresa de un CFDI o RET.
2. Consultar el WebService del SAT de estado de un CFDI.

Ejemplo de expresión para CFDI 3.3 && CFDI 4.0:

https://verificacfdi.facturaelectronica.sat.gob.mx/default.aspx?id=CEE4BE01-ADFA-4DEB-8421-ADD60F0BEDAC&re=POT9207213D6&rr=DIM8701081LA&tt=2010.01&fe=/OAgdg==

Ejemplo de expresión para CFDI 3.2:

?re=AAA010101AAA&rr=COSC8001137NA&tt=0000001234.567800&id=CEE4BE01-ADFA-4DEB-8421-ADD60F0BEDAC

Ejemplo de expresión para RET 1.0:

?re=XAXX010101000&nr=12345678901234567890&tt=1234567890.123456&id=ad662d33-6934-459c-a128-BDf0393f0f44

Ejemplo de expresión para RET 2.0:

https://prodretencionverificacion.clouda.sat.gob.mx/?id=ad662d33-6934-459c-a128-BDf0393f0f44&re=XAXX010101000&nr=12345678901234567890&tt=1234567890.12&fe=/OAgdg==

Documentación

La documentación está disponible en el sitio web NodeCfdi

Soporte

Puedes obtener soporte abriendo un ticket en Github.

Adicionalmente, esta librería pertenece a la comunidad OcelotlStudio, así que puedes usar los mismos canales de comunicación para obtener ayuda de algún miembro de la comunidad.

Compatibilidad

Esta librería se mantendrá compatible con al menos la versión con soporte activo de Node más reciente.

También utilizamos Versionado Semántico 2.0.0 por lo que puedes usar esta librería sin temor a romper tu aplicación.

Contribuciones

Las contribuciones con bienvenidas. Por favor lee CONTRIBUTING para más detalles y recuerda revisar el archivo CHANGELOG.

Copyright and License

The @nodecfdi/cfdi-expresiones library is copyright © NodeCfdi - OcelotlStudio and licensed for use under the MIT License (MIT). Please see LICENSE for more information.

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

v3.0.4

Commits

• chore: :arrow_up: update dependencies and remove dom support for better nodejs integration d0ab3a8
• refactor: :recycle: apply all usage of types provide by cfdi-core for dom support f0a6bf4

v3.0.3 - 2024-09-11

Commits

• chore(release): :tada: 3.0.3 97ef474
• chore: :arrow_up: update dependencies, eslint config and changelog generator b3a621b
• docs: :memo: update readme badge build 991dac5

v3.0.2 - 2024-08-14

Commits

• chore(release): :tada: 3.0.2 804e841
• chore: :construction: add support to future base cfdi-core releases dffbf73

v3.0.1 - 2024-08-12

Commits

• chore(release): :tada: 3.0.1 758feab
• refactor: :recycle: prefer usage of alias path for better directory conventional 751bcb3
• chore: :hammer: update script post build for add generate docs 5763f5d

v3.0.0 - 2024-07-06

Merged

• chore: prepare for only usage main branch #53

Commits

• refactor: :construction: remove old config files, workflows and docs f97fe3c
• docs: :memo: update generate api docs with latest change on base code 66e1109
• docs: generate docs f5ddef0

v2.1.6 - 2023-07-19

Merged

• chore: version bump 2.1.6 #31

Commits

• chore: apply new suite of rules and update dependencies 9cf7718
• docs: generate docs f9a608f
• ci: update workflow with latest github updates and pnpm updates c23ea2d

v2.1.5 - 2023-03-31

Merged

• chore: version bump 2.1.5 #18

Commits

• chore: update dependencies and fixed exports for support commonjs and module f67cfdc
• docs: generate docs 71d3543
• refactor: remove rollup plugins and configs and usage tsup ee018de

v2.1.4 - 2023-02-22

Merged

• chore: version bump #14

Commits

• docs: generate docs 24488e6
• chore: update deps and fixed imports for bundlers 1b02d74
• chore(deps): update vitest monorepo to ^0.28.0 66b5499

v2.1.3 - 2023-01-18

Merged

• chore: version bump 2.1.3 #11

Commits

• chore: update deps and update gen lib from microbundle to rollup and for types add api-extractor 38148aa
• docs: generate docs 1ee2371
• chore: apply lint fixes and increment code coverage to 100 and with browser added testings 1cd1e96

v2.1.2 - 2022-07-05

Merged

• Version bump 2.1.2 #6

Commits

• docs: generate docs cf753ec
• chore(deps): update dependencies 5870da9
• fix(typescript): change from custom path to relative path for error on types generation 789a42f

v2.1.1 - 2022-07-01

Merged

• Version bump 2.1.1 #5
• fix: problems with sonarcloud and git attributes #4

Commits

• docs: generate docs c95e673
• chore: apply lint rules and update configs d4b1559
• test: coverage 100% and apply DOM agnostic 36027a1

v2.1.0 - 2022-06-29

Merged

• Version 2.1.0 #2

Commits

• build: update files for bundled lib with microbundle 03ea8b2
• chore: remove docs files, new version of docs will be generate 2a089a4
• refactor: abstract common methods to traits and test individually 172920c

v2.0.1 - 2022-06-15

Commits

• docs: prepare docs for release version 2.0.1 061f27a
• test: added test for retenciones20 foreign and decimal place only two decimals 9fdbb60
• fix: retenciones20 added missing order and value fe, reduce decimals on MontoTotOperacion 89348fd

v2.0.0 - 2022-06-14

Commits

• feat: added support to cfdi4.0 and retenciones 2.0 e28dc69
• docs: update generated docs with new information ad54a96
• docs: prepare for release version 2.0.0 ac2eb03

v1.1.1 - 2021-12-13

Commits

• fix: resolve issue reported on https://github.com/phpcfdi/cfdi-expresiones/issues/11 b4a2d99
• docs: added updated docs for release v1.1.1 3d2589a

v1.1.0 - 2021-12-11

Commits

• chore: initial commit eb15ad8
• chore: added GitHub Action Workflow cdb12ab