X12 158 — Tax Jurisdiction Sourcing
Le 158 transporte l'attribution de juridiction fiscale pour une transaction commerciale : code FIPS, taux applicable, période de validité.
Objet
Le 158 documente la décision de sourcing fiscal multi-juridictionnel pour une vente : à quelle juridiction (État, comté, ville, district spécial) attribuer la taxation, et à quel taux. Il est utilisé par les moteurs de calcul fiscal type Vertex ou Avalara, et par les administrations fiscales locales pour la déclaration multi-juridiction.
C'est une transaction de référence (lookup-style), pas une transaction d'événement : on l'utilise typiquement en réponse à une requête d'information ou pour synchroniser une code-list interne. Elle complète le 813 (Tax Return Data) qui porte la déclaration elle-même.
Structure d'enveloppe
Le 158 voyage à l'intérieur des trois niveaux d'enveloppe X12 (ISA/IEA,
GS/GE avec functional group TJ, et ST/SE).
Exemple didactique en 004010 :
ISA*00* *00* *ZZ*VERTEX *ZZ*ACMERETAIL *260514*1015*U*00401*000000158*0*P*>~
GS*TJ*VERTEX*ACMERETAIL*20260514*1015*1*X*004010~
ST*158*0001~
BGN*00*TJ-2026-0042*20260514~
N1*PR*VERTEX INC*92*VRTX~
N1*PE*ACME RETAIL CO*92*0001~
LX*1~
N4*COLUMBUS*OH*43215*US*CY*39049~
DTM*007*20260101~
DTM*036*20261231~
AMT*TX*0.0725~
REF*ZZ*FIPS-39049-COLUMBUS~
SE*10*0001~
GE*1*1~
IEA*1*000000158~ Segments courants
- Header —
ST,BGN,DTM. - Parties —
N1*PR(Provider = moteur fiscal),N1*PE(Payee = retailer). - Juridiction — boucle
LXavecN4(City / State / ZIP / Country / FIPS code),DTM(validité),AMT*TX(taux),REF(identifiant FIPS). - Summary —
SE.
Pièges courants
- FIPS vs ZIP :
N4doit porter le code FIPS du comté (élément 8), pas seulement le ZIP — un même ZIP peut traverser plusieurs comtés et donc plusieurs taux. - Période de validité : encoder
DTM*007(effective from) etDTM*036(effective to) ; un taux sans plage de validité ne peut pas être archivé proprement dans le moteur fiscal. - Districts spéciaux : transit, écoles, fire districts ajoutent du taux ; ne pas les rouler dans un seul
AMT*TX, mais en lignesLXséparées par autorité.
Transactions liées
Documentation
Le code 158 et le nom Tax Jurisdiction Sourcing sont publics et listés sur x12.org/products/transaction-sets. La structure complète des loops, qualifiers et code-lists est distribuée par DISA via les Implementation Guides (TR3) propriétaires. ediverse.io ne couvre que les concepts publics, l'enveloppe et des exemples didactiques.