완벽 가이드:
브라질 NF-e 추출
모든 브라질 NF-e XML에는 500개 이상의 구조화된 데이터 필드가 포함되어 있으며, 여기에는 ICMS 및 PIS/COFINS 크레딧 환급을 결정하는 품목별 세금 내역도 포함됩니다. 그러나 대부분의 AP 팀은 20개 미만만 추출합니다. 이 가이드는 NF-e XML을 실제로 활용 가능한 스프레드시트 데이터로 변환하기 위한 완벽한 참고 자료입니다: 필드 매핑 테이블, 주별 ICMS 세율 검증, CST 및 CFOP 코드 참조, ICMS-ST 처리, 그리고 2026년 이중 스키마 전환에 필요한 실무 단계를 다룹니다.

핵심 요약
- NF-e XML에는 500개 이상의 구조화된 데이터 필드가 포함되어 있지만, 대부분의 AP 팀은 20개 미만만 추출하여 ICMS 크레딧 환급과 PIS/COFINS 매입세액 추적이 완전히 보이지 않는 상태로 남습니다.
- 병목은 데이터 가용성이 아닙니다 — XML은 정부에서 검증됩니다 — 각 품목이 네 개의 개별 세금 트리(ICMS, IPI, PIS, COFINS)를 중첩하고 있으며, 각 트리에는 10개 이상의 CST 코드 변형이 있어 0 값이 크레딧 포지션에 미치는 의미가 달라진다는 점입니다.
- 네 개의 세금 분기를 한 번에 매핑하는 하나의 시맨틱 추출 템플릿은 모든 NF-e를 불투명한 XML 파일에서 투명한 크레딧 환급 도구로 바꿔줍니다 — BRL 100,000 인보이스에서 잘못된 제도 가정 하나가 BRL 9,250의 놓친 크레딧을 초래합니다.
브라질 NF-e에서 데이터를 추출하는 것은 일반 인보이스에서 데이터를 추출하는 것과 근본적으로 다릅니다. PDF 형식의 표준 인보이스는 시각적 레이아웃에서 필드를 읽기 위해 OCR 또는 AI 기반 문서 이해가 필요합니다. NF-e는 XML 파일로 도착합니다. 설계상 기계 판독이 가능하며, 해당 상품이 창고를 떠나기 전에 브라질 주 세무 당국인 SEFAZ가 400개 이상의 자동화 규칙에 대해 구조를 검증한 것입니다.
문제는 데이터 가용성이 아닙니다. 데이터 복잡성입니다. 유럽 Peppol BIS 인보이스는 약 100개의 XML 요소를 사용합니다. 레이아웃 버전 4.0의 NF-e는 여러 중첩 수준에 걸쳐 분산된 500개 이상의 구조화된 요소 그룹을 포함하며, 각 품목마다 네 개의 별도 세금 계산 분기가 있고, 각각 고유한 세금 상황 코드, 과세 표준 계산, 세율, 공제 규칙을 사용합니다. 데이터는 완전하지만, 올바르게 추출하려면 각 필드의 의미와 다른 필드와의 연결 방식을 이해해야 합니다.
이 가이드는 실무 참고 자료로 설계되었습니다. NF-e 추출 워크플로를 처음 설정하는 경우 섹션 2의 단계별 워크플로부터 시작하십시오. 이미 추출 파이프라인을 운영 중이며 특정 ICMS 세율을 검증하거나 CFOP 코드를 조회해야 하는 경우 섹션 3~6의 참조 표로 이동하십시오. 각 섹션은 독립적으로 사용할 수 있지만, 전체 가치는 완전한 그림에 있습니다. 즉, 어떤 필드를 추출할지, 올바른지 확인하는 방법, NF-e가 취소 이벤트나 비상 상황 표시와 함께 도착했을 때 어떻게 해야 하는지를 아는 것입니다.
NF-e가 완전히 처음이라면, 추출 세부 사항을 살펴보기 전에 Nota Fiscal Eletrônica 초보자 가이드부터 시작하십시오. 이 가이드는 기본적인 DANFE와 XML의 차이, SEFAZ 승인 프로세스, 네 가지 핵심 세금을 이해하고 있다고 가정하며, 해당 데이터를 올바르게 추출하는 데 초점을 맞춥니다.
NF-e 추출이 일반 인보이스 추출과 다른 점
세 가지 구조적 차이가 NF-e 추출의 작동 방식과, PDF 업로드·열 정의·데이터 추출로 이어지는 표준 인보이스 추출 방식이 문제의 일부만 해결하는 이유를 규정합니다.
1. 소스는 시각적 문서가 아니라 XML입니다. 일반 인보이스 추출은 읽기 문제입니다. AI 또는 OCR 시스템이 페이지에서 텍스트를 찾아내고, 어느 문자열이 인보이스 번호인지 인식하여 올바른 열에 매핑해야 합니다. NF-e 추출은 파싱 및 매핑 문제입니다. 데이터는 이미 기계 판독 가능한 태그에 들어 있지만, XML 구조는 포르투갈어 태그 이름(<emit>은 발행자, <dest>는 수신자, <imposto>는 세금)을 사용하며 세금 제도에 따라 깊게 중첩된 계층 구조를 가집니다. 추출 과제는 "데이터 찾기"에서 "각 출력 열에 올바른 XML 경로 매핑하기"로 바뀝니다.
2. 세금 구조는 다차원적입니다. 단일 NF-e 품목 라인에는 최대 네 가지 독립적인 세금 계산이 포함됩니다. ICMS(주 단위, CST 코드에 따라 10가지 이상 변형), IPI(연방 소비세, 제품 의존적), PIS, COFINS(연방 사회 기여금)입니다. 각 세금은 자체 계산 기준, 세율, CST(세금 상황 코드), 공제 적격성 규칙을 가집니다. 하나의 세율이 라인 전체에 적용되는 EU 부가가치세 인보이스와 달리, NF-e 품목 라인에는 별도의 <ICMS>, <IPI>, <PIS>, <COFINS> 하위 그룹이 있으며 각각 과세 기준이 다를 수 있습니다. 합계만 추출하면 각 세금 공제가 올바르게 계산되었는지 판단하는 세부 정보를 놓치게 됩니다.
3. 추출 워크플로는 발행 이후의 이벤트를 고려해야 합니다. NF-e는 24시간 이내에 취소될 수 있습니다. 특정 필드를 수정하는 Carta de Correção(CC-e)를 받을 수 있습니다. SEFAZ에 연결할 수 없을 때 비상 모드로 발행될 수 있습니다. 수신자 측 이벤트인 manifestação do destinatário를 발생시킵니다. 이는 구매자가 수령을 확인하거나, 거래를 인정하거나, 거부해야 하는 법적 의무입니다. 완전한 추출 파이프라인은 초기 XML만 추출하고 끝내는 것이 아니라 이러한 이벤트 기반 변경을 처리해야 합니다. 취소 및 비상 규칙이 AP 워크플로에 미치는 영향에 대한 자세한 내용은 NF-e 처리 복잡성 분석을 참조하십시오.
이 세 가지 차이는 NF-e 추출이 "포르투갈어 필드 이름을 가진 인보이스 추출"이 아님을 의미합니다. 이는 문서 OCR보다 EDI 파싱에 가까우면서도 대부분의 EDI 표준을 훨씬 뛰어넘는 세금 복잡성을 지닌 독자적인 범주입니다. 자체적인 구조적 복잡성을 가진 또 다른 주요 라틴 아메리카 전자 인보이스 시스템에 대해서는 멕시코 CFDI 추출 완전 가이드를 참조하십시오.
완전한 NF-e 추출 워크플로: 단계별 안내
수동, 스크립트 기반, AI 기반 등 어떤 방식이든 NF-e 추출 워크플로는 동일한 논리적 순서를 따릅니다. 각 단계는 다음 단계로 이어지는 특정 결과물을 생성합니다.
DANFE가 아닌 XML을 수집하세요
모든 NF-e 거래는 XML 파일을 생성합니다. 공급업체가 DANFE만 보냈다면, DANFE에 인쇄된 44자리 접근 키를 사용해 발행 주의 SEFAZ 포털에서 전체 XML을 다운로드하세요. 브라질 법률은 공급업체가 XML을 제공하도록 요구하며, 추출과 의무 5년 보관 모두에 XML이 필요합니다. 원본 XML은 수령한 그대로 저장하세요. 수정하면 디지털 서명이 무효화되고 감사 추적이 깨집니다.
접근 키와 SEFAZ 상태를 확인하세요
데이터를 처리하기 전에 NF-e가 유효한지 확인하세요. <chNFe> 요소에서 44자리 chave de acesso를 추출하고 SEFAZ 웹 서비스나 포털에 조회하세요. 상태가 "Autorizada"(승인)인지 확인하세요. "Cancelada"(취소)나 "Denegada"(거부)가 아니어야 합니다. NF-e는 발행 후 24시간 이내에 취소될 수 있으므로 이 단계는 모든 스크립트나 도구 기반 워크플로에서 자동화해야 합니다. 추출 시점에 접근 키를 확인하면 더 이상 법적 효력이 없는 문서를 처리하는 것을 방지할 수 있습니다.
XML 구조를 그룹으로 파싱하세요
NF-e XML은 예측 가능한 최상위 구조를 가집니다. 주요 요소 그룹은 다음과 같습니다. <ide>(문서 식별), <emit>(발행자/공급업체), <dest>(수신자/귀사), <det>(품목별로 반복되는 라인 항목), <total>(세금 유형별로 하나씩인 인보이스 합계), <transp>(운송/운임), <cobr>(결제/청구), <infAdic>(추가 정보). 추출 스크립트나 도구는 각 그룹을 독립적으로 파싱한 다음 라인 항목 수준에서 결과를 결합해야 합니다.
참조 표를 사용해 필드를 출력 열에 매핑하세요
스프레드시트나 ERP 가져오기 파일에 필요한 각 필드에 대해 정확한 XML 경로, 예상 데이터 유형, 필요한 변환(날짜는 ISO 형식으로, 금액은 소수점 두 자리로, CNPJ 문자열은 0 패딩 유지)을 파악하세요. 아래 섹션 3의 필드 매핑 참조를 사용하세요. 이 단계의 핵심 구분: 헤더 수준 필드(NF-e당 한 번 추출)와 라인 항목 필드(모든 <det> 요소마다 추출)를 분리하세요. 출력 구조도 이를 반영해야 합니다. 인보이스당 한 행인 헤더 테이블과 인보이스당 여러 행인 라인 항목 테이블입니다.
참조 데이터로 세금 계산 검증
NF-e XML에는 귀사의 계산이 아닌 공급업체의 세금 계산이 포함되어 있습니다. 추출 워크플로에는 검증 절차를 포함해야 합니다. ICMS 세율이 출발지-도착지 주 조합에 맞는 올바른 세율인가? IPI 세율이 제품의 NCM 코드 범위에 해당하는가? CST 코드가 CFOP가 설명하는 거래 유형과 일치하는가? 이 가이드의 섹션 4에서 이러한 검증에 필요한 참조 표를 제공합니다. 불일치가 발견되면 검토 대상으로 표시하고, 불일치하는 세금 데이터를 ERP에 조용히 가져오지 마십시오.
내보내기, 보관 및 이벤트 모니터링
구조화된 데이터를 ERP 또는 스프레드시트로 내보내십시오. 원본 XML(수신한 그대로, 수정 없이)과 추출 결과를 모두 보관하십시오. 그런 다음 모니터링 프로세스를 설정하십시오. 추출 후 48시간이 지나면 추출된 NF-e 문서의 SEFAZ 상태를 다시 확인하여 취소 또는 정정 이벤트를 포착하십시오. 공급업체는 귀사에 통지하지 않고 24시간 이내에 NF-e를 취소할 수 있습니다. 이미 취소된 NF-e에서 데이터를 추출하여 ERP에 전기했다면, 취소 기록을 생성해야 합니다. 자동화 도구로 이 모니터링 단계를 처리할 수 있지만, 사람이 하는 팀은 종종 이를 놓칩니다.
NF-e XML 필드 매핑 참조
다음 표는 필수 NF-e XML 경로를 스프레드시트 열에 매핑합니다. 필드는 중요도에 따라 Critical(기본 처리에 필수), Important(세금 검증 및 세액 공제 복구에 필요), Niche(통관이나 SPED 신고 등 특정 시나리오에 필요)로 분류됩니다. 모든 경로는 표준 NF-e XML 네임스페이스를 기준으로 합니다.
헤더 필드 (인보이스당 한 행)
| 출력 열 | XML 경로 (<nfeProc>/<NFe>/<infNFe> 기준) | 예시 값 | 중요도 |
|---|---|---|---|
| 액세스 키(Chave de Acesso) | @Id("NFe" 접두사 제거) 또는 <ide>/<cNF>와 접두사 조합 | 35200600012345000106550010000012341012345678 | 치명적 |
| NF-e 번호 | <ide>/<nNF> | 1234 | 치명적 |
| NF-e 시리즈 | <ide>/<serie> | 1 | 치명적 |
| 발행일 | <ide>/<dhEmi> | 2026-06-15T14:30:00-03:00 | 치명적 |
| SEFAZ 승인 프로토콜 | <ide>/<nProt> | 135260001234567 | 치명적 |
| 발행 유형 | <ide>/<tpEmis> | 1(정상), 2-6(비상) | 중요 |
| 공급업체 CNPJ | <emit>/<CNPJ> | 00.000.000/0001-91 | 치명적 |
| 공급업체 법인명 | <emit>/<xNome> | Fornecedor Exemplo Ltda | 치명적 |
| 공급업체 주 등록번호 | <emit>/<IE> | 123.456.789.110 | 중요 |
| 공급업체 주(IBGE 코드) | <emit>/<enderEmit>/<cUF> | 35(São Paulo), 33(Rio de Janeiro) | 치명적 |
| 구매자 CNPJ | <dest>/<CNPJ> | 00.000.000/0002-82 | 치명적 |
| 구매자 주(IBGE 코드) | <dest>/<enderDest>/<cUF> | 31(Minas Gerais) | 치명적 |
| NF-e 총액 | <total>/<ICMSTot>/<vNF> | 12500.00 | 치명적 |
| 총 ICMS 금액 | <total>/<ICMSTot>/<vICMS> | 1500.00 | 중요 |
| 총 ICMS-ST 금액 | <total>/<ICMSTot>/<vST> | 450.00 | 중요 |
| 총 IPI 금액 | <total>/<ICMSTot>/<vIPI> | 625.00 | 중요 |
| 총 PIS 금액 | <total>/<ICMSTot>/<vPIS> | 206.25 | 중요 |
| 총 COFINS 금액 | <total>/<ICMSTot>/<vCOFINS> | 950.00 | 중요 |
| 할인 금액 | <total>/<ICMSTot>/<vDesc> | 250.00 | 틈새 |
| 운임 금액 | <total>/<ICMSTot>/<vFrete> | 350.00 | 중요 |
| 보험 금액 | <total>/<ICMSTot>/<vSeg> | 50.00 | 틈새 |
| 결제/청구 정보 | <cobr>/<dup>/<dVenc> (만기일) 및 <vDup> (금액) | 2026-07-15 / 12500.00 | 중요 |
| CFOP (헤더 수준 — 일반적으로 첫 번째 품목에서 가져옴) | <det>[1]/<prod>/<CFOP> | 2101 | 중요 |
| 운영 성격 | <ide>/<natOp> | Venda de mercadoria adquirida de terceiros | 틈새 |
품목 필드 (제품 라인당 한 행)
<infNFe> 내의 각 <det> 요소는 하나의 제품 라인을 나타냅니다. nItem 속성은 라인 번호(1부터 시작)를 제공합니다. 다음 필드는 각 <det>마다 반복됩니다:
| 출력 열 | XML 경로 (<det>당) | 중요도 |
|---|---|---|
| 라인 번호 | @nItem | 필수 |
| 제품 코드 (공급업체 내부 코드) | <prod>/<cProd> | 중요 |
| 제품 설명 | <prod>/<xProd> | 필수 |
| NCM 코드 (8자리 제품 분류) | <prod>/<NCM> | 필수 |
| CFOP 코드 (4자리 회계 운영) | <prod>/<CFOP> | 필수 |
| CST — ICMS 세금 상황 코드 | <imposto>/<ICMS>/<ICMS00>/<CST> (하위 그룹에 따라 다름) | 필수 |
| 수량 | <prod>/<qCom> | 필수 |
| 단가 | <prod>/<vUnCom> | 필수 |
| 라인 합계 (총액) | <prod>/<vProd> | 필수 |
| ICMS 과세 기준액 (BC ICMS) | <imposto>/<ICMS>/<ICMS00>/<vBC> | 중요 |
| ICMS 세율 (%) | <imposto>/<ICMS>/<ICMS00>/<pICMS> | 중요 |
| ICMS 금액 | <imposto>/<ICMS>/<ICMS00>/<vICMS> | 필수 |
| ICMS-ST 과세 기준액 (해당하는 경우) | <imposto>/<ICMS>/<ICMSST>/<vBCST> | 중요 |
| ICMS-ST 금액 (해당하는 경우) | <imposto>/<ICMS>/<ICMSST>/<vICMSST> | 중요 |
| IPI 과세 기준액 | <imposto>/<IPI>/<IPITrib>/<vBC> | 중요 |
| IPI 세율 (%) | <imposto>/<IPI>/<IPITrib>/<pIPI> | 중요 |
| IPI 금액 | <imposto>/<IPI>/<IPITrib>/<vIPI> | 중요 |
| PIS 과세표준 | <imposto>/<PIS>/<PISAliq>/<vBC> | 중요 |
| PIS 세율 (%) | <imposto>/<PIS>/<PISAliq>/<pPIS> | 중요 |
| PIS 금액 | <imposto>/<PIS>/<PISAliq>/<vPIS> | 중요 |
| COFINS 과세표준 | <imposto>/<COFINS>/<COFINSAliq>/<vBC> | 중요 |
| COFINS 세율 (%) | <imposto>/<COFINS>/<COFINSAliq>/<pCOFINS> | 중요 |
| COFINS 금액 | <imposto>/<COFINS>/<COFINSAliq>/<vCOFINS> | 중요 |
| UOM (측정 단위) | <prod>/<uCom> | 틈새 |
| GTIN/EAN (제품 바코드) | <prod>/<cEAN> | 틈새 |
| EX TIPI (IPI 면세 코드) | <prod>/<EXTIPI> | 틈새 |
ICMS 하위 그룹에 관한 중요 참고사항: <imposto> 내의 ICMS XML 경로는 CST 코드에 따라 달라집니다. 정상 과세되는 ICMS는 <ICMS00> 하위 그룹을 사용합니다. 다른 CST 코드는 <ICMS10>(과세 + ST), <ICMS20>(감면 기준), <ICMS30>(일반 ICMS 면제 ST), <ICMS40>(면세), <ICMS51>(유예), <ICMS60>(기징수), <ICMS90>(기타), <ICMSPart>(DIFAL — 주간 세율 차액), <ICMSST>(세금 대체)를 사용합니다. 추출 매핑은 <ICMS00>뿐만 아니라 이 모든 변형을 처리해야 합니다.
세금 검증: 추출한 숫자를 확인하는 방법
NF-e XML에는 공급업체가 직접 계산한 세금이 포함되어 있으며, 이는 잘못되었을 수 있습니다. SEFAZ는 XML 구조가 완전하고 기본 산술이 일치하는지 검증하지만, 출발지-목적지 조합에 올바른 ICMS 세율이 적용되었는지, 또는 IPI 세율이 NCM 코드의 공식 TIPI 세율과 일치하는지는 확인하지 않습니다. 이는 구매자인 귀하의 책임이며, 브라질 AP에서 환급 가능한 초과 지급의 가장 흔한 원인입니다.
주(州) 조합별 ICMS 주간 거래 세율 검증
주간 거래의 ICMS 세율은 출발지 주(공급업체가 출하하는 곳)와 목적지 주(귀하의 법인이 위치한 곳)에 따라 달라집니다. 이 표를 사용하여 NF-e의 ICMS 세율이 해당 주 조합에 맞는 올바른 세율과 일치하는지 검증하십시오:
| 출발지 주 | 목적지 주 | 표준 ICMS 세율 | 비고 |
|---|---|---|---|
| 남부/동남부 주(SP, RJ, MG, ES, PR, SC, RS) | 남부/동남부 주 | 12% | 남부/동남부 지역 내 표준 주간 거래 세율 |
| 남부/동남부 주 | 북부/북동부/중서부 주 | 7% | 저개발 지역에 대한 인하 세율 (Art. 2, I, LC 87/96) |
| 북부/북동부/중서부 주 | 모든 주(남부/동남부 포함) | 12% | 개발도상 지역에서의 표준 출하 세율 |
| 모든 주 | 모든 주(해외 함량 40% 초과 수입품) | 4% | Resolução Senado 13/2012 — 수입 함량이 40%를 초과하는 제품에 적용 |
| 공급 주 = 수령 주(주 내 거래) | 동일 주 | 17%–22% | 주별로 다름: SP=18%, RJ=20%, MG=18%, PR=19%, RS=17% 등 |

NF-e의 ICMS 세율이 출발지-목적지 조합(<emit>/<enderEmit>/<cUF>에서 <dest>/<enderDest>/<cUF>까지)에 대해 예상되는 세율과 일치하지 않으면 해당 문서를 검토 대상으로 표시하십시오. 세율 불일치는 브라질 공급업체 인보이스에서 가장 흔한 오류 중 하나이며, 잘못된 세액 공제 계산으로 이어질 수 있습니다.
CST 코드: 모든 것을 바꾸는 세금 상황 코드
CST(Código da Situação Tributária)는 세금이 어떻게 적용되었는지를 알려주는 세 자리 코드로, 단순한 세율이 아닙니다. NF-e의 모든 ICMS, IPI, PIS, COFINS 계산에는 각각의 CST가 있습니다. CST의 첫 번째 자리는 세금 체제의 기원을 나타냅니다(0=국내, 1=해외, 2=국내 함량이 있는 해외 — 세금에 따라 다름). 특히 ICMS의 경우, CST는 ICMS가 과세 대상인지, 면제인지, 유예인지, 대체(ST)인지, 또는 특별 체제를 통해 징수되는지를 결정합니다. 세 자리 ICMS CST 코드는 특정 논리를 따릅니다:
| CST (ICMS) | 의미 | 크레딧 사용 가능? | AP 영향 |
|---|---|---|---|
| 00 | 과세 — 전체 ICMS 세율 적용 | 예 | 표준 구매. vBC, pICMS, vICMS를 정상적으로 추출합니다. |
| 10 | 과세 + 세금 대체 (ICMS-ST) | 예 (일반 ICMS만) | 두 가지 ICMS 금액: 일반 및 ST. 둘 다 추출하세요 — ST 금액은 크레딧이 아닙니다. |
| 20 | 축소된 계산 기준으로 과세 | 예 (비례) | 과세 기준이 축소됩니다(예: 1/3). vBC 필드는 축소된 기준을 반영합니다. |
| 30 | 일반 ICMS 면제 + ST 적용 | 아니오 | 추출할 일반 ICMS가 없습니다. ST 필드만 존재합니다. 비용에 ST 금액이 포함됩니다. |
| 40 | 면제 — ICMS 부과 없음 | 아니오 | ICMS 값이 없습니다. 라인 합계는 동일하지만 크레딧이 생성되지 않습니다. |
| 41 | 면제 — 비과세 | 아니오 | CST 40과 유사합니다. 추출하거나 크레딧할 ICMS가 없습니다. |
| 51 | 유예 — ICMS 납부가 이후 단계로 연기됨 | 상황에 따라 다름 | vICMS가 0이더라도 vBC와 pICMS를 추출하세요 — 유예는 향후 이벤트에 영향을 미칩니다. |
| 60 | 공급업체(또는 체인의 이전 링크)가 이미 ICMS를 징수함 | 아니오 | 연료, 에너지, 통신에서 흔합니다. ICMS는 라인 항목이 아닙니다 — 상류에서 지불되었습니다. |
| 70 | 축소된 기준으로 과세 + ST | 예 (비례) | 하이브리드: 일반 ICMS에 대한 축소된 기준 + 별도의 ST 금액. 둘 다 추출해야 합니다. |
| 90 | 기타 — 위에 해당하지 않는 특별 체제 | 상황에 따라 다름 | 수동으로 검토하세요. NF-e의 <infAdic>이 체제를 설명해야 합니다. |
추출 워크플로는 항상 세금 금액과 함께 CST 코드를 캡처해야 합니다 — CST 40(면제)의 "제로 ICMS"는 CST 00(오류)의 "제로 ICMS"와 매우 다른 상황입니다. CST는 제로가 합법적인 재정 처리인지 아니면 조사해야 할 데이터 공백인지를 결정합니다.
IPI, PIS, COFINS 검증
IPI 검증: IPI 세율은 제품의 NCM 코드에 따라 결정됩니다. 브라질은 모든 NCM 코드에 대한 IPI 세율을 매핑한 종합 세율표인 TIPI(Tabela de Incidência do IPI)를 공개합니다. TIPI 전체 스프레드시트를 내부적으로 유지할 수는 없지만(수천 개 항목이 포함되어 있고 Receita Federal이 주기적으로 업데이트함), 고액 항목은 부분 검증할 수 있습니다. NCM을 추출하고, 해당 TIPI 세율 범위를 조회한 뒤, pIPI 필드가 예상 범위 내에 있는지 확인하십시오. IPI CST 코드도 중요합니다. CST 50은 IPI 면세를, 00은 과세를 의미합니다.
PIS 및 COFINS 검증: 이러한 연방 기여금은 누적 또는 비누적 제도 중 하나로 적용됩니다. 제도는 공급자의 세무 분류에 따라 결정되며, 세율과 구매자인 귀하의 크레딧 가용성 모두를 좌우합니다:
| 제도 | PIS 세율 | COFINS 세율 | 합계 | 구매자 크레딧 여부 |
|---|---|---|---|---|
| 비누적 (Lucro Real) | 1.65% | 7.6% | 9.25% | 예 — 구매자는 자신의 기여금에 대해 PIS 및 COFINS를 크레딧받을 수 있습니다 |
| 누적 (Lucro Presumido) | 0.65% | 3.0% | 3.65% | 아니요 — 누적 제도에서는 매입 크레딧이 발생하지 않습니다 |
NF-e의 PIS 세율이 1.65%이고 COFINS가 7.6%라면 공급자는 비누적 제도에 해당하며, 귀하는 PIS/COFINS 매입 크레딧을 청구할 수 있습니다. 세율이 0.65%와 3.0%라면 크레딧은 없습니다. 공급자의 CST(일반적으로 01 = 비누적 또는 02 = 누적)가 제도를 확인해 줍니다. 이러한 세율을 추출하고 검증하는 것은 귀하의 환급 가능 세무 포지션에 직접 영향을 미칩니다.
실무 검증 규칙: 모든 NF-e에 대해 품목별로 PIS 세율과 COFINS 세율을 추출하십시오. 합계 세율이 9.25%라면 크레딧 추적 대상으로 표시하십시오. 3.65%라면 공급자 제도를 확인하고 PIS/COFINS 크레딧이 적용되지 않음을 기록하십시오. BRL 100,000 인보이스에서 제도를 한 번 잘못 가정하면 BRL 9,250의 크레딧을 놓치거나, BRL 5,600을 잘못 청구하게 됩니다.
ICMS 세금 대체(ICMS-ST): 무시할 수 없는 메커니즘
ICMS-ST(Substituição Tributária)는 세무 당국이 전체 공급망의 ICMS 징수 책임을 첫 번째 고리, 일반적으로 제조업체나 수입업체에 부여하는 메커니즘입니다. 공급망의 각 구매자(제조업체 → 유통업체 → 소매업체)가 자신의 마진에 대한 ICMS를 납부하는 대신, 제조업체가 공급망 시작 단계에서 소비자에 대한 추정 최종 판매가를 기준으로 ICMS를 징수합니다. 이러한 납세자 "대체"는 세금 징수 지점을 상류로 이동시킵니다.

NF-e 문서를 처리하는 AP 팀에게 ICMS-ST는 두 가지 시나리오로 나타납니다:
시나리오 1 — 귀사가 공급망 중간에 있는 경우(대체 납세 당사자로부터 구매). 귀사는 제조업체로부터 ST로 이미 구매한 유통업체로부터 상품을 구매합니다. NF-e에는 일반 ICMS(CST 00, 정상 과세)와 별도의 ICMS-ST 금액(CST 10, <ICMS10> 또는 <ICMSST> 하위)이 포함됩니다. 추출 시 두 가지를 모두 포착해야 합니다: 일반 ICMS는 귀사의 투입세액 공제이고, ICMS-ST는 공제가 아닙니다 — 상류 공급업체가 이미 SEFAZ에 납부한 비용 포함 부과금입니다. 환급받을 수 없습니다.
시나리오 2 — 귀사가 최종 고리인 경우(소매업체 또는 직접 소비자). 귀사는 ST 대체 납세 당사자인 공급업체로부터 구매합니다. NF-e에는 단일 ICMS-ST 금액(CST 30 — 일반 ICMS 면제, ST 적용)이 포함됩니다. 공급망의 전체 ICMS 비용이 이 하나의 금액에 내재되어 있습니다. 추출 시 ST 필드만 포착되며, 일반 ICMS 공제는 제공되지 않습니다.
추출 워크플로에서 이 두 시나리오를 구분하려면 CST 코드를 확인하십시오: CST 10 = 일반 ICMS + ST(부분 공제 가능), CST 30 = ST만(일반 ICMS 공제 없음). ICMS-ST XML 경로는 별도의 하위 그룹을 사용합니다: ST 금액은 <imposto>/<ICMS>/<ICMSST>/<vICMSST>, ST 계산 기준은 <vBCST>입니다. 이를 일반 ICMS와 별도의 열로 추출하십시오 — 절대 하나의 "총 ICMS" 필드로 합산하지 마십시오. 일부 AP 팀은 일반 ICMS와 ST를 합산하여 통합 금액으로 전기하는데, 이는 ICMS 공제 포지션을 과대 계상하여 감사 지적을 초래합니다.
CFOP와 NCM: 규정 준수를 좌우하는 분류 코드 추출
NF-e의 각 항목에는 해당 제품의 세금 처리를 결정하는 두 가지 코드가 포함됩니다. 이는 선택적 메타데이터가 아니라 세금 산정 로직의 입력값입니다.
CFOP 코드 참조 (첫 자리 분류)
CFOP(Código Fiscal de Operações e Prestações)는 네 자리 코드로, 첫 자리가 거래의 방향과 성격을 나타냅니다. 매입(구매 측) NF-e 처리에서 가장 자주 마주치는 CFOP 코드는 1xxx, 2xxx, 3xxx 범위에 속합니다:
| 첫 자리 | 분류 | 일반적인 매입 코드 |
|---|---|---|
| 1 | 매입 — 동일 주 내(주 내 거래) | 1102 = 재판매용 구매, 1101 = 산업화용 구매, 1116 = 사용/소비용 구매 |
| 2 | 매입 — 다른 주에서(주 간 거래) | 2101 = 산업화용 구매, 2102 = 재판매용 구매, 2116 = 사용/소비용 구매 |
| 3 | 매입 — 해외에서(수입) | 3101 = 산업화용 수입, 3102 = 재판매용 수입, 3126 = 사용/소비용 수입 |
| 5 | 매출(판매) — 구매 측 NF-e에는 거의 나타나지 않음 | — |
| 6 | 주 간 매출 — NF-e를 발행하는 경우에만 해당 | — |
| 7 | 해외 매출 — 수출 거래 | — |
CFOP가 추출에서 중요한 이유: CFOP 코드는 해당 거래에 어떤 ICMS 규칙이 적용되는지를 결정합니다. 1로 시작하는 CFOP(주 내 거래)는 ICMS 세율이 공급자 주의 내부 세율(17-22%)이어야 하며, 주 간 세율이 아닙니다. 2로 시작하는 CFOP(주 간 거래)는 세율이 위의 주 간 세율표와 일치해야 합니다. CFOP와 ICMS 세율이 일치하지 않는 경우 — 예를 들어 CFOP 1102(주 내 거래)에 ICMS 세율 12%(주 간 세율)가 적용된 경우 — 해당 인보이스에는 수정이 필요한 구조적 불일치가 있습니다. 추출 워크플로에서 이를 자동으로 표시해야 합니다.
NCM 코드: IPI와 수입 관세를 결정하는 제품 분류
NCM(Nomenclatura Comum do Mercosul)은 Harmonized System(HS)을 기반으로 하며 메르코수르 전용 2자리가 추가된 8자리 제품 분류 코드입니다. 형식: NNNN.NN.NN(앞 6자리가 HS 코드). NCM 코드는 다음을 결정합니다:
- IPI 세율: TIPI 표를 통해 매핑됩니다. 특정 장으로 시작하는 NCM을 가진 제품은 더 높거나 낮은 IPI 세율이 적용됩니다.
- ICMS-ST 적용 여부: 특정 NCM 장은 주(州) 간 의무 ICMS-ST 프로토콜(convênios)의 대상입니다.
- 수입 관세(II) — 국제 구매 시.
- 대체 세율(예: CONFAZ 프로토콜에 따른 간소화된 ICMS-ST 계산).
추출 시 NCM은 항상 선행 0을 보존하는 텍스트 필드로 캡처해야 합니다. 절대 숫자로 변환하지 마십시오 — NCM 8471.30.00(컴퓨터 장비)을 숫자로 처리하면 선행 구조가 손실됩니다. 또한 NCM은 워크플로에 자동 세율 검증이 포함된 경우 IPI 세율을 조회하는 기본 키 역할을 합니다.
추출 워크플로에서 NF-e 특수 이벤트 처리
NF-e는 정적 문서가 아닙니다. 법적으로 정의된 일련의 이벤트를 통해 수정, 취소 또는 재발행될 수 있습니다. 완전한 추출 워크플로는 이미 추출한 데이터를 변경할 수 있는 이러한 이벤트를 반드시 고려해야 합니다.
취소. 발행자는 승인 프로토콜 수신 후 24시간 이내에 NF-e를 취소할 수 있으며, 단 물품이 물리적으로 이동하지 않은 경우에 한합니다. 취소 이벤트는 SEFAZ에 등록되고 동일한 접근 키에 연결됩니다. 24시간 이후에는 취소가 더 이상 불가능하며, 발행자는 세무 당국을 통해 특별 취소를 요청하거나 대변 전표(NF-e de devolução)를 발행해야 합니다. 추출 워크플로의 경우: 핵심 검증은 추출 시점과 결제 전에 NF-e 상태를 확인하는 것입니다. NF-e 문서를 프로그래밍 방식으로 처리하는 경우, 구매자가 수신한 NF-e 상태 목록을 SEFAZ ConsNFeDest 웹 서비스에 조회하는 상태 확인 단계를 포함하십시오.
Carta de Correção (CC-e). 공급업체가 이미 승인된 NF-e의 필드(예: 제품 설명 수정, 배송 주소 정정, 결제 기한 업데이트)를 수정해야 하는 경우, NF-e의 접근 키에 연결된 전자 수정서인 CC-e를 발행합니다. CC-e는 XML을 대체하지 않고 특정 필드를 수정합니다. 추출 워크플로는 NF-e 문서를 처리할 때 해당 접근 키에 대한 CC-e 이벤트가 존재하는지 조회해야 합니다. ImageToTable.ai의 배치 처리에는 추출된 문서에 대한 수정 이벤트 확인 옵션이 포함되어 있습니다 — 공급업체가 CC-e를 통해 기한을 수정했는데 워크플로가 원본 XML의 기한을 사용했다면, 잘못된 일정으로 결제하게 되기 때문입니다.
비상 모드. SEFAZ에 연결할 수 없는 경우, 공급업체는 비상 모드로 NF-e를 발행할 수 있습니다. 발행 유형(<ide>/<tpEmis>)은 비상 방법을 나타냅니다: 2 = FS-DA(타이핑된 DANFE), 3 = EPEC(사전 이벤트 비상), 4 = DPEC(전자 비상), 5 = FS-IA(양식 비상), 6 = SVC(SEFAZ Virtual Contingency — 백업 승인 서버). 비상 모드에서는 추출 시점에 NF-e에 전체 SEFAZ 승인 프로토콜이 없을 수 있습니다. 워크플로는 비상 발행 문서를 후속 조치 대상으로 표시해야 합니다: 시스템이 복구되면 공급업체가 전체 NF-e를 전송하므로, 최종 XML을 검색하고 필드가 변경된 경우 다시 추출해야 합니다.
Manifestação do Destinatário. 이것은 공급업체 이벤트가 아니라 구매자의 의무입니다. 브라질 법률에 따라 상품 구매자는 정해진 기한 내에 SEFAZ 포털에 이벤트 응답을 등록해야 합니다. 발행 후 10일 이내에 수령을 확인하고 거래를 수락하거나 거부해야 합니다. 이 과정을 manifestação do destinatário라고 하며 SEFAZ의 DF-e 플랫폼을 통해 관리됩니다. manifestação은 추출과는 별개의 컴플라이언스 단계이지만, 추출 워크플로는 처리된 각 NF-e의 접근 키를 manifestação 추적 시스템에 기록하여 컴플라이언스 담당자가 필요한 이벤트를 제때 신고할 수 있도록 해야 합니다. manifestação을 등록하지 않으면 SEFAZ는 해당 거래가 미확인된 것으로 간주하며, 이로 인해 해당 공급업체의 향후 NF-e 발행이 차단될 수 있습니다.
이러한 이벤트 유형과 AP 운영에 미치는 영향에 대한 자세한 내용은 NF-e 처리 복잡성 분석을 참조하십시오.
추출 방법 비교: 귀하의 물량에 맞는 접근 방식
NF-e 데이터를 추출하는 일반적인 방법은 네 가지이며, 적합한 방법은 물량, 기술 리소스, 그리고 품목별 세금 세부 정보가 필요한지 아니면 헤더 합계만 필요한지에 따라 달라집니다.
| 방법 | 작동 방식 | 추출 필드 | 적합한 물량 | 주요 한계 |
|---|---|---|---|---|
| 수동 DANFE 입력 | 담당자가 인쇄된 DANFE를 읽고 Excel 또는 ERP에 입력 | 약 20개의 헤더 필드, 품목별 세금 세부 정보 없음 | 월 10건 미만 | 모든 세금 내역을 포함한 데이터의 90%를 누락, 높은 오류율 |
| XML 스크립팅 (Python, Power Query) | 맞춤 스크립트가 NF-e XML을 파싱하여 CSV/Excel로 필드 추출 | 모든 헤더 + 품목별 필드, 사전 정의된 XPath 매핑 필요 | 월 10–100건 | 코딩 기술 필요, 스키마 업데이트 시 중단(2026 이중 스키마), 내장된 세금 검증 없음 |
| ERP 현지화 모듈 (SAP/Oracle/Dynamics) | NF-e XML을 수신하여 GL에 자동 전기하는 브라질 전용 ERP 모듈 | 전체 필드 세트, 세금 계정 매핑, SPED 통합 | 월 100건 이상 | 높은 비용(라이선스 + 구현), 해당 ERP가 있어야만 작동, 경직된 스키마 매핑 |
| AI 기반 추출 | DANFE PDF 또는 NF-e XML을 업로드하면 AI가 파싱하여 사용자 정의 열에 매핑 | PDF에서 DANFE에 표시되는 모든 필드, XML에서 전체 필드 | 월 10–500건 이상 | XML 파싱은 도구가 구조화된 데이터 입력(단순 시각적 PDF가 아닌)을 지원해야 함 |
NF-e에서 중요한 구분은 추출 방법이 DANFE와 XML 모두를 처리하는지 여부입니다. 공급업체가 혼합 방식으로 보내는 경우 — 일부는 XML을 직접 전송하고 다른 일부는 DANFE만 인쇄하여 발송 — 두 소스를 일관되게 처리하는 방법이 필요합니다. ImageToTable.ai는 두 가지를 모두 지원합니다. 동일한 배치에 원시 NF-e XML 파일과 DANFE PDF를 함께 업로드하고, 단일 열 템플릿을 정의하여 통합 스프레드시트를 얻을 수 있습니다. 이 도구는 위에서 설명한 가변적인 ICMS 하위 그룹 경로도 처리합니다. 이는 스키마 복잡성으로 인해 스크립팅 팀이 수십 가지 XPath 변형을 유지해야 하는 상황에서 상당한 이점입니다. 여러 NF-e 문서의 배치 처리에 대한 실용적인 안내는 배치 NF-e 처리 가이드를 참조하십시오.
파일은 안전하게 처리되며 저장되지 않습니다.
2026년 세제 개혁에 대비한 추출 워크플로 준비

브라질의 헌법 수정안 132/2023과 보완법 214/2025는 기존 5개 세금을 2개의 새로운 세금으로 대체하는 이중 부가가치세(VAT) 제도를 도입했습니다. NF-e 추출 측면에서 이는 현재 파싱하는 XML 스키마가 2026년 8월부터 2033년까지의 전환 기간 동안 기존 세금 필드와 새로운 세금 필드를 모두 포함하게 된다는 것을 의미합니다. 추출 수준에서 무엇이 바뀌는지, 그리고 이에 대해 무엇을 해야 하는지 살펴보겠습니다.
유지되는 것: 전체 XML 구조(<ide>, <emit>, <det>, <total>)는 동일하게 유지됩니다. 헤더 필드, 품목별 수량, NCM 코드, CFOP 코드는 영향을 받지 않습니다.
바뀌는 것: 각 품목의 <imposto> 섹션과 <total> 요약 그룹에 새로운 XML 요소 그룹이 추가됩니다. 새로운 그룹은 기존 ICMS, IPI, PIS, COFINS 필드와 함께 CBS(연방) 및 IBS(주/시) 세금 계산을 포함합니다. 전환 기간 동안에는 두 세트의 필드를 모두 추출하여 다운스트림 시스템에서 모두 사용할 수 있도록 해야 합니다.
| 현행 세금 | 대체 세금 | 추출 영향 | 전환 일정 |
|---|---|---|---|
| PIS (1.65% / 0.65%) | CBS (연방, ~8.8%) | 새로운 <CBS> 요소가 <PIS>와 함께 나타납니다. 전환 기간에는 둘 다 추출해야 합니다. CBS는 2033년까지 PIS를 완전히 대체합니다. | 2026년: CBS 테스트 필드 (0.9% 세율). 2027년: CBS 시행, PIS 폐지. |
| COFINS (7.6% / 3.0%) | CBS (연방, ~8.8%) | PIS와 동일 — COFINS 필드가 CBS 필드와 공존합니다. PIS+COFINS 통합 추출은 합산된 CBS 세율을 고려해야 합니다. | 2027년: COFINS 폐지, CBS 전액 세율 적용. |
| ICMS (주, 내부 거래 17-22%, 주간 거래 4-12%) | IBS (주/시, ~17.7%) | vBC, pIBS, vIBS를 포함한 새로운 <IBS> 요소 그룹. ICMS와 IBS는 품목별로 공존합니다. 추출 시 두 세금 기준액을 모두 포착해야 하며, 이는 다를 수 있습니다. | 2026년: IBS 테스트 필드 (0.1% 세율). 2029-2032년: IBS가 주별로 단계적으로 도입되어 ICMS를 점진적으로 대체합니다. |
| IPI (NCM별 0-330%) | IS (선택세, 변동) | IS가 IPI를 점진적으로 대체합니다. 전환 기간에는 IPI와 IS가 공존할 수 있습니다. NCM은 제품 분류 기준으로 유지됩니다. | IPI 세율은 2027년부터 0으로 인하되기 시작합니다. 2033년까지 완전 대체됩니다. |
추출 워크플로를 준비하기 위한 세 가지 실무 단계:
현재 필드 맵 점검
추출 템플릿을 검토하여 현재 ICMS, IPI, PIS 또는 COFINS에 매핑된 모든 필드를 확인하십시오. 각 필드에 대해 해당하는 새 세금(CBS는 PIS/COFINS, IBS는 ICMS, IS는 IPI)을 위한 병렬 필드를 추가하십시오. 아직 새 필드를 사용하지 않더라도 CBS/IBS 필드가 채워질 때 데이터를 받을 수 있도록 추출 출력 열이 존재하도록 스키마 공간을 매핑해야 합니다.
이중 스키마 샘플 NF-e 문서로 테스트
이미 새 CBS 및 IBS 필드를 포함하는 샘플 NF-e XML을 공급업체에 요청하십시오(2026년 8월 1일 이후 발행되는 모든 NF-e에 두 필드가 포함됩니다). 이를 추출 파이프라인을 통해 실행하고 기존 및 새 세금 필드가 올바르게 추출되는지 확인하십시오. 추출이 스크립트 기반인 경우 ICMS에 대한 XPath 쿼리가 실수로 IBS 값을 캡처하지 않는지 확인하십시오. 요소 그룹의 이름 지정 패턴이 유사합니다.
이중 필드 전략 결정
향후 7-8년 동안 추출된 데이터에는 기존 및 새 세금 필드가 모두 포함됩니다. (a) 출력 스프레드시트에 병렬 열을 유지하고 다운스트림 사용자가 사용할 열을 선택하도록 할지, (b) 특정 열은 특정 날짜에 단계적으로 도입하고 다른 열은 단계적으로 폐지하는 마이그레이션 일정을 구현할지 결정하십시오. 대부분의 AP 팀은 전환 초기 몇 년 동안 옵션 (a)를 선호합니다. 출력 테이블이 길어지지만 혼합 체제 기간 동안 유일하게 유효한 필드를 놓칠 위험을 피할 수 있습니다.
자주 묻는 질문
NF-e 필드를 추출할 때 XML 네임스페이스를 처리해야 하나요?
예. NF-e XML은 <nfeProc> 요소에 선언된 기본 네임스페이스(일반적으로 xmlns="http://www.portalfiscal.inf.br/nfe")를 사용합니다. 모든 XPath 쿼리는 이 네임스페이스를 등록하거나(Python의 lxml에서는 ns = {'nfe': 'http://www.portalfiscal.inf.br/nfe'}) local-name()을 사용하여 우회해야 합니다. Power Query의 XML 커넥터는 대부분의 경우 네임스페이스를 자동으로 처리합니다. 추출 도구가 명시적 네임스페이스 등록을 요구하는 경우 올바른 URI를 사용하는지 확인하십시오. URI가 일치하지 않으면 빈 결과 집합이 조용히 반환됩니다.
품목별 세액을 합산하여 헤더 합계와 비교해야 하나요?
예 — 이는 구현할 수 있는 가장 가치 있는 검증 중 하나입니다. NF-e XML은 <total>/<ICMSTot>에 세금 합계를, 각 <det>에 품목별 세부 정보를 담고 있습니다. 이 둘은 일치해야 합니다. 품목별 합계와 헤더 합계 간의 불일치는 위험 신호입니다. XML 생성 시 품목이 누락되었거나, 할인이 일관성 없이 적용되었거나, 공급업체의 ERP에 구성 오류가 있을 수 있음을 나타냅니다. 모든 추출 배치에서 품목별 세액을 헤더 합계와 대사하는 것을 표준 단계로 삼으십시오.
NF-e 추출이 SPED 신고 요건을 충족하나요?
아니요. SPED(Sistema Público de Escrituração Digital)는 브라질의 디지털 장부 신고 시스템으로, 주세용 EFD-ICMS/IPI와 연방 기여금용 EFD-Contribuições가 있으며, 데이터를 특정 SPED 레이아웃에 맞게 포맷하여 인증된 소프트웨어를 통해 제출해야 합니다. NF-e 추출은 인보이스 데이터를 스프레드시트로 가져올 뿐, SPED 규격 레코드를 생성하지는 않습니다. 그러나 NF-e에서 추출하는 데이터(품목별 ICMS, PIS, COFINS, CFOP, NCM, CST)는 SPED 신고에 입력되는 것과 동일한 데이터입니다. 추출 워크플로가 품목 수준에서 세금 세부 정보를 올바르게 캡처한다면, 브라질 회계 팀은 원본 문서에서 다시 입력하는 대신 해당 데이터를 사용하여 필요한 SPED 레코드를 채울 수 있습니다. NF-e 필드에서 SPED 레이아웃 위치로의 매핑은 일부 ERP 현지화 모듈이 자동으로 처리하는 별도의 변환 단계입니다.
회사가 여러 브라질 주에 걸쳐 여러 CNPJ를 보유한 경우에는 어떻게 해야 합니까?
대규모 조직에서 흔한 일입니다. 각 CNPJ(포르투갈어로 "estabelecimento")는 세무 목적상 별도의 법인이며, NF-e의 목적지 주는 물품을 수령한 CNPJ에 해당합니다. 다중 법인 조직의 NF-e 데이터를 추출할 때는 수령인 CNPJ(<dest>/<CNPJ>)를 기준으로 추출 결과를 필터링하고 법인별로 별도의 GL 매핑을 유지하십시오. ICMS 세율 검증도 법인별로 다릅니다. 상파울루 CNPJ로 배송된 물품은 같은 공급업체에서 출고되었더라도 바이아 CNPJ로 배송된 물품과 다른 세율이 적용됩니다. 브라질의 주별 복잡성 처리에 대한 자세한 내용은 저렴한 NF-e 추출 가이드를 참조하십시오.
과거 기간의 데이터를 추출한 상태에서 NCM 코드가 변경되면 어떻게 됩니까?
NCM 코드는 Receita Federal에 의해 주기적으로 갱신됩니다(일반적으로 연 1회이지만, 때로는 Notas Técnicas를 통해 연중 조정이 이루어지기도 합니다). NCM 코드가 변경되면 해당 제품 분류의 IPI 세율도 변경될 수 있습니다. 추출 목적상 NCM 코드는 발행 시점의 NF-e에 표시된 그대로 캡처해야 합니다. 이는 인보이스 날짜에 유효했던 코드이며 법적으로 납부해야 할 세금을 결정합니다. 소급 분석이나 SPED 조정을 수행하는 경우에는 현재 NCM 목록이 아닌 원본 문서에 기록된 NCM을 사용하십시오.
공급업체의 NF-e XML에 누락되거나 잘못된 요소가 있는 경우에는 어떻게 해야 합니까?
이런 일은 발생합니다. 가장 흔한 문제는 <cobr>(청구) 그룹 누락, <enderEmit>의 불완전한 주소, 또는 선언된 CST 코드에 대해 예상되는 스키마 변형을 따르지 않는 ICMS 하위 그룹입니다. 추출 워크플로는 이러한 상황을 원활하게 처리해야 합니다. 누락된 필드에 대해서는 null 또는 자리 표시자를 반환하고 검증 경고를 기록하십시오. 중요하지 않은 누락 요소로 인해 절대 실패 처리하지 마십시오. 중요 필드(액세스 키, CNPJ, 품목 합계)의 경우 값이 누락되면 명확한 오류 메시지와 함께 해당 NF-e를 배치에서 거부해야 합니다. 검증 요약 보고서는 필수적입니다. 누락되거나 비정상적인 필드가 있는 모든 NF-e를 기록하여 팀이 GL에 전기하기 전에 조사할 수 있도록 하십시오.
DIFAL(주 간 ICMS 세율 차액)은 어떻게 처리해야 하나요?
DIFAL(Diferencial de Alíquota do ICMS)은 상품이 주 경계를 넘어 판매되고 목적지 주의 ICMS 세율이 출발지에서 지불한 주간 세율보다 높을 때 적용됩니다. 구매자는 자기 주에 세율 차액을 납부해야 합니다. NF-e에서 DIFAL은 <imposto>/<ICMS> 아래의 <ICMSPart> 하위 그룹으로 표현됩니다. 이 하위 그룹에는 vBC(계산 기준액), pICMS(이미 적용된 주간 세율), pICMSUf(목적지 주의 내부 세율), vICMS(기준액에 대한 두 세율의 차액인 DIFAL 금액)가 포함됩니다. DIFAL 금액은 별도로 추출하여 주별 ICMS 크레딧 워크플로를 통해 처리해야 하며, 일반 ICMS 크레딧의 일부가 아닙니다.
운임과 보험료를 제품 가액과 별도로 추출해야 하나요?
예. NF-e XML은 거래를 제품 가액(vProd), 운임(vFrete), 보험료(vSeg), 기타 비용(vOutro)으로 구분합니다. ICMS 과세 기준액에는 제품 가액 + 운임 + 보험료 + 기타 비용의 합계가 포함되는 경우가 많지만, 항상 그런 것은 아닙니다. 일부 제품은 제품 가액에 대해서만 ICMS가 계산됩니다. 각 구성 요소를 별도로 추출하면 ICMS 과세 기준액이 가격 구조에 대한 이해와 일치하는지 검증할 수 있습니다. NF-e에서 운임이 ICMS 기준액에 포함되어 있지만 ERP 모델에서는 운임이 ICMS 기준액 밖에 있을 것으로 예상하는 경우, 해결해야 할 조정 항목이 생깁니다.
AI 기반 추출 도구는 전체 NF-e XML을 처리할 수 있나요, 아니면 DANFE PDF만 처리할 수 있나요?
도구에 따라 다릅니다. ImageToTable.ai의 AI 기반 추출은 NF-e XML 파일(구조화 데이터)과 DANFE PDF(시각적 문서)를 동일한 배치에서 모두 처리할 수 있습니다. XML을 업로드하면 도구가 구조화된 요소를 직접 읽어(OCR 불필요) 열 템플릿에 매핑합니다. DANFE PDF를 업로드하면 AI가 시각적 콘텐츠를 읽고 표시된 필드를 추출합니다. 두 형식을 하나의 플랫폼에서 처리할 때의 핵심 이점은 일관성입니다. "NF-e Access Key", "ICMS Amount", "CFOP Code"에 대해 하나의 열 템플릿을 정의하면, 도구가 수신한 소스 문서에 관계없이 해당 열을 채웁니다. 이로써 XML 기반 공급업체와 DANFE 기반 공급업체를 위한 별도 워크플로를 유지할 필요가 없어집니다. 이는 브라질 AP 운영에서 흔히 발생하는 분절 지점입니다.
추출 결과물도 XML과 함께 보관해야 하나요?
브라질 법률은 거래가 발생한 회계연도 말부터 5년간 원본 NF-e XML을 보관하도록 요구합니다. 추출 결과물(스프레드시트 또는 ERP 기록)은 XML을 대체할 수 없습니다. 다만 원본 XML 아카이브와 함께 구조화된 추출 결과물을 유지하는 것이 내부 대사 및 감사 대응을 위한 모범 사례입니다. SEFAZ 감사 시에는 일반적으로 두 가지를 모두 제출해야 합니다. 즉, 문서의 존재와 적법한 승인을 입증하는 원본 XML과 데이터가 어떻게 처리되었는지를 보여주는 회계 기록입니다. 접근 키를 조인 키로 사용하여 원본 XML과 추출 결과물을 연결된 구조로 자동 보관하는 추출 워크플로는 감사 준비 시간을 크게 절약해 줍니다. 비용 효율적인 규정 준수 방안은 소규모 사업자를 위한 NF-e 추출 가이드를 참조하십시오.
자신의 NF-e 문서로 추출 테스트하기
NF-e 추출은 이론적인 연습이 아닙니다. 수신하는 모든 XML에는 완전히 구조화되고 정부에서 검증된, 즉시 사용 가능한 데이터가 담겨 있습니다. 문제는 워크플로가 ERP나 재무 기록에 도달하기 전에 충분히 추출하고 올바르게 검증하는지 여부뿐입니다. 이 가이드의 필드 맵, 세금 검증 테이블, 코드 참조는 참조 계층을 제공합니다. 추출 엔진이 문서를 처리합니다. 이 조합은 브라질 NF-e를 팀이 파싱하기 어려워하는 불투명한 XML 파일에서 전기, 크레딧 환급, 감사 방어에 자신 있게 사용할 수 있는 투명한 재무 데이터 소스로 바꿔줍니다.