# PBMS Backend

> API multi-tenant para benefícios, cadastro ao programa, carrinho e pedidos no PBM.

Tecnologia com propósito

Documentação da API **PBMS** (prefixo `pbm/api/v2`).
Use a**Referência da API** na barra lateral para explorar todos
os endpoints, esquemas e exemplos gerados a partir do OpenAPI.

**Base URL**

`https://{tenant}.mapeiatechcompany.store` — sem
barra final.

**Prefixo**

Todas as rotas desta spec usam `pbm/api/v2` (sem `/`
inicial no path relativo ao host).

**Auth**

`POST /auth` e `POST /auth/refresh` para JWT; demais
fluxos de negócio com `Authorization: Bearer`, salvo política
pública do gateway.

![fluxograma do PBM](/_fern-files/developers.mapeiatechcompany.store/380eedf9f33e57c2d074e145be9b71d835e499612a49df8d4b34363ed023102e/docs/assets/pbm_flowchart.svg)

## Conteúdo

* **Visão geral** — você está aqui.
* **Referência da API** — contrato OpenAPI completo (autenticação, cadastro ao programa, carrinho, transações, pedidos).

Para ambientes locais, ajuste `base_url` e o prefixo conforme o teu deploy.

---

## Dúvidas e suporte

Contato: [[contato@mapeitech.co](mailto:contato@mapeitech.co)](mailto:contato@mapeitech.co)

> Documentação da API PBMS — autenticação, programa, carrinho, pedidos e PBM.

## Instructions for AI Agents

- For clean Markdown of any page, append `.md` to the page URL
- For section-specific indexes, append `/llms.txt` to any section URL
- For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.mapeiatechcompany.store/_mcp/server

## Docs

- [PBMS Backend](https://developers.mapeiatechcompany.store/.md): API multi-tenant para benefícios, cadastro ao programa, carrinho e pedidos no PBM.

## API Docs

- Referência da API > Authentication [Access token](https://developers.mapeiatechcompany.store/referencia-da-api/authentication/post-access-token.md)
- Referência da API > Authentication [Refresh token](https://developers.mapeiatechcompany.store/referencia-da-api/authentication/post-refresh-token.md)
- Referência da API > Products [Listar produtos com benefício](https://developers.mapeiatechcompany.store/referencia-da-api/products/get-products-list.md)
- Referência da API > Products [Produto por EAN](https://developers.mapeiatechcompany.store/referencia-da-api/products/get-product-by-ean.md)
- Referência da API > Products [Elegibilidade / verificação de programa PBM](https://developers.mapeiatechcompany.store/referencia-da-api/products/get-product-program-verification.md)
- Referência da API > Products [Cotação de benefício sem documento (anônimo)](https://developers.mapeiatechcompany.store/referencia-da-api/products/post-product-generic-benefit.md)
- Referência da API > Products [Cotação de benefício com documento](https://developers.mapeiatechcompany.store/referencia-da-api/products/post-product-benefit-by-document.md)
- Referência da API > Program Registration [Lookup por documento](https://developers.mapeiatechcompany.store/referencia-da-api/program-registration/get-onboarding-by-document.md)
- Referência da API > Program Registration [Consulta CEP (ViaCEP)](https://developers.mapeiatechcompany.store/referencia-da-api/program-registration/get-postalcode-lookup.md)
- Referência da API > Program Registration [Dados pessoais](https://developers.mapeiatechcompany.store/referencia-da-api/program-registration/put-onboarding-personal-data.md)
- Referência da API > Program Registration [Endereço](https://developers.mapeiatechcompany.store/referencia-da-api/program-registration/put-onboarding-address.md)
- Referência da API > Program Registration [Gênero e responsabilidade](https://developers.mapeiatechcompany.store/referencia-da-api/program-registration/put-onboarding-gender-responsibility.md)
- Referência da API > Program Registration [Profissional (CRM/CRO) na receita](https://developers.mapeiatechcompany.store/referencia-da-api/program-registration/put-onboarding-doctor-name.md)
- Referência da API > Program Registration [Aceites LGPD](https://developers.mapeiatechcompany.store/referencia-da-api/program-registration/put-onboarding-acceptances.md)
- Referência da API > Program Registration [Agregado cadastro + PBM (serviço)](https://developers.mapeiatechcompany.store/referencia-da-api/program-registration/get-document-benefit.md)
- Referência da API > Program Registration [Ativar cliente no PBM](https://developers.mapeiatechcompany.store/referencia-da-api/program-registration/post-consumer-activate.md)
- Referência da API > Doctors [Listar registro médico](https://developers.mapeiatechcompany.store/referencia-da-api/doctors/get-doctors-registry.md)
- Referência da API > Doctors [Consulta única por CRM/CRO](https://developers.mapeiatechcompany.store/referencia-da-api/doctors/get-doctors-lookup.md)
- Referência da API > Orders [Listar pedidos](https://developers.mapeiatechcompany.store/referencia-da-api/orders/get-orders.md)
- Referência da API > Orders [Detalhe do pedido](https://developers.mapeiatechcompany.store/referencia-da-api/orders/get-order-by-id.md)
- Referência da API > Cart Pbm [Notificar PBM no carrinho](https://developers.mapeiatechcompany.store/referencia-da-api/cart-pbm/post-cart-notify-pbm.md)
- Referência da API > Transactions Pbm [Efetiva de pedido (effective) para o PBM](https://developers.mapeiatechcompany.store/referencia-da-api/transactions-pbm/post-transactions-notify-pbm-order.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://developers.mapeiatechcompany.store/openapi.json)
- [OpenAPI YAML](https://developers.mapeiatechcompany.store/openapi.yaml)