---
title: "Mapa de cross-repos — peças transversais"
description: "Onde vivem as peças transversais do NFS-e Inbound: HMAC, polling ADN, signed URLs, auth, rate limiting. Referência rápida para consultar contrato técnico e abrir ticket no time certo."
source_url: https://nfe.io/docs/distribuicao-nfse-inbound-cross-repos/
last_updated: 2026-07-30
---

# Mapa de cross-repos — peças transversais

Esta página mapeia onde vivem as peças transversais que o produto NFS-e Inbound depende mas **não implementa**. Use como referência rápida quando precisar consultar contrato técnico, abrir ticket no time certo, ou linkar issue.

## Sumário

- [Tabela de cross-repos](#tabela-de-cross-repos)
- [Como usar este mapa](#como-usar-este-mapa)

## Tabela de cross-repos

| Concern | Lives in | Canonical doc |
|---|---|---|
| Webhook HMAC validation (`x-hub-signature`) | `nfe/shared-webhook-api` | [docs/webhook-signature-validation.md](https://github.com/nfe/shared-webhook-api/blob/main/docs/webhook-signature-validation.md) |
| Polling DFe via ADN (NSU, polling ~30s) | `nfe/dfetech-distribution-api` | [docs/01-doc-tecnica-equipe-dev.md](https://github.com/nfe/dfetech-distribution-api/blob/main/docs/01-doc-tecnica-equipe-dev.md) (interno) |
| Signed URLs para XML/PDF (TTL 30min) | `nfe/dfetech-distribution-api` | docs/02-doc-tecnica-clientes-dev-nfse-inbound-api.md §11 |
| API Key & JWT auth | TODO — confirmar repo de identity | — |
| Rate limiting & circuit breaker | `nfe/dfetech-distribution-api` | docs/01-doc-tecnica-equipe-dev.md §6 |
| Bulk export pipeline (XML/PDF/CSV) | `nfe/shared-usage-api` | docs internos do shared-usage-api |

## Como usar este mapa

- Precisa **validar HMAC** no seu endpoint? Vá ao `shared-webhook-api`, não tente reimplementar a partir desta doc.
- Precisa entender **por que o polling é ~30s** ou como o circuit breaker dispara? `dfetech-distribution-api` tem o contrato canônico.
- Precisa **gerar bulk export** (ZIPs de XML/PDF ou CSV analítico)? O endpoint é no `shared-usage-api` — veja [Como fazer: Bulk export](./how-to/bulk-export.md).

## Veja também

- [Arquitetura](./explanation/arquitetura.md)
- [Webhook events](./reference/webhook-events.md)
- [Troubleshooting](./reference/troubleshooting.md)