O BulkRoute valida automaticamente esses limites nas cotações. Se um item exceder o limite, o Correios é descartado da cotação e o log explica o motivo.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"BulkRoute Central de Ajuda","colors":{"primary":"#2563eb","light":"#3b82f6","dark":"#1d4ed8"},"logo":{"light":"https://mintcdn.com/bulkroute/3b7W0SLBzshYyGcU/images/logo-light.svg?fit=max\u0026auto=format\u0026n=3b7W0SLBzshYyGcU\u0026q=85\u0026s=0a9290ede9e4a8387b55515feeea5769","dark":"https://mintcdn.com/bulkroute/3b7W0SLBzshYyGcU/images/logo-dark.svg?fit=max\u0026auto=format\u0026n=3b7W0SLBzshYyGcU\u0026q=85\u0026s=f424020e9995c8c6c9bce44c7723ea01","href":"https://www.bulkroute.com.br"},"favicon":"https://mintcdn.com/bulkroute/MhOHZ8TDV_D22IoT/images/favicon.svg?fit=max\u0026auto=format\u0026n=MhOHZ8TDV_D22IoT\u0026q=85\u0026s=9e12a37e0bd5f20833e1d0afc33a0163","navbar":{"links":[{"href":"https://app.bulkroute.com.br","label":"Painel Admin"},{"href":"mailto:suporte@bulkroute.com.br","label":"Suporte"}],"primary":{"type":"button","label":"Acessar Plataforma","href":"https://app.bulkroute.com.br"}},"footer":{"socials":{"website":"https://www.bulkroute.com.br","instagram":"https://instagram.com/bulkroute"}},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"bulkroute","hasAudioNarration":false,"actualSubdomain":"bulkroute","customDomains":["docs.bulkroute.com.br"],"gitSource":{"type":"github","owner":"isaaclopes","repo":"bulkroute-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6abd408b4d04591a291392f0","collectionId":"2ab2ed48-f5b3-455b-86a5-58bc1a2abe04","liveDeploymentHistoryId":"6abd408b4d04591a291392f0","schemaVersion":"v3"},"entitlements":{},"buildId":"6abd408b4d04591a291392f0","clientVersion":"0.0.4067","searchFilterCounts":[{"language":"default","tag":"Documentação","count":27},{"language":"default","tag":"Operação Diária","count":17},{"language":"default","tag":"Painel Admin","count":9},{"language":"default","tag":"Seções do Painel","count":8},{"language":"default","tag":"Como Usar","count":7},{"language":"default","tag":"Transportadoras","count":7},{"language":"default","tag":"Conectando Transportadoras","count":7},{"language":"default","tag":"Integrações","count":6},{"language":"default","tag":"ERPs \u0026 Marketplaces","count":6},{"language":"default","tag":"API \u0026 Integração","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"transportadoras/correios","slug":"/transportadoras/correios","pageMetadata":{"title":"Configurando os Correios (CWS API)","description":"Conecte seu contrato dos Correios via nova API CWS para SEDEX, PAC e Mini Envios.","href":"/transportadoras/correios"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Conecte seu contrato dos Correios via nova API CWS para SEDEX, PAC e Mini Envios.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Table,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Table)_missingMdxReference(`Table`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`O BulkRoute utiliza a API moderna dos Correios (CWS / REST) com autenticação baseada em cartão de postagem corporativo.`}),`\n`,_jsx(Heading,{level:`2`,id:`credenciais-necessárias`,children:`Credenciais Necessárias`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Usuário do Portal Meu Correios`}),` (geralmente o e-mail ou CNPJ).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Código de Acesso da API`}),` (gerado no portal CWS).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Cartão de Postagem`}),` (número com 10 dígitos).`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Número do Contrato`}),`.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`como-obter`,children:`Como obter`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`Acesse o `,_jsx(_components.a,{href:`https://www.correios.com.br/meu-correios`,children:`Portal Meu Correios`})]}),`\n`,_jsxs(_components.li,{children:[`Vá em `,_jsx(_components.strong,{children:`Serviços`}),` > `,_jsx(_components.strong,{children:`API Correios`})]}),`\n`,_jsx(_components.li,{children:`Solicite o acesso à API CWS para seu contrato`}),`\n`,_jsxs(_components.li,{children:[`Gere o `,_jsx(_components.strong,{children:`código de acesso`}),` e anote o `,_jsx(_components.strong,{children:`cartão de postagem`})]}),`\n`,_jsx(_components.li,{children:`Tenha em mãos o número do seu contrato (encontrado no documento contratual)`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`configuração-no-bulkroute`,children:`Configuração no BulkRoute`}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`No painel BulkRoute, selecione `,_jsx(_components.strong,{children:`Transportadoras`}),` > `,_jsx(_components.strong,{children:`Correios`}),`.`]}),`\n`,_jsx(_components.li,{children:`Preencha os campos com suas credenciais CWS.`}),`\n`,_jsx(_components.li,{children:`Ative os serviços desejados:`}),`\n`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Código`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Serviço`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Prazo típico`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`left`},children:_jsx(_components.code,{children:`03220`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`SEDEX Contrato`}),_jsx(_components.td,{style:{textAlign:`left`},children:`1-3 dias úteis`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`left`},children:_jsx(_components.code,{children:`03298`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`PAC Contrato`}),_jsx(_components.td,{style:{textAlign:`left`},children:`3-10 dias úteis`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`left`},children:_jsx(_components.code,{children:`04227`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Mini Envios`}),_jsx(_components.td,{style:{textAlign:`left`},children:`5-15 dias úteis`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`left`},children:_jsx(_components.code,{children:`03204`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`SEDEX 10`}),_jsx(_components.td,{style:{textAlign:`left`},children:`1 dia útil`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`left`},children:_jsx(_components.code,{children:`03205`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`SEDEX 12`}),_jsx(_components.td,{style:{textAlign:`left`},children:`1 dia útil`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`left`},children:_jsx(_components.code,{children:`03206`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`SEDEX Hoje`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Mesmo dia`})]})]})]}),`\n`,_jsxs(_components.ol,{start:`4`,children:[`\n`,_jsxs(_components.li,{children:[`Clique em `,_jsx(_components.strong,{children:`Testar Conexão`}),` para validar se o cartão de postagem está ativo e com saldo/limite liberado.`]}),`\n`,_jsx(_components.li,{children:`Salve as configurações.`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`cubagem-nos-correios`,children:`Cubagem nos Correios`}),`\n`,_jsxs(_components.p,{children:[`Os Correios usam fator de cubagem `,_jsx(_components.strong,{children:`6000`}),` (cm³ → kg), diferente das transportadoras rodoviárias (fator 300):`]}),`\n`,_jsx(CodeBlock,{numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Peso cubado = (Comprimento × Largura × Altura) ÷ 6000`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.p,{children:[`O BulkRoute calcula automaticamente e compara com o peso real — a cobrança é pelo `,_jsx(_components.strong,{children:`maior`}),`.`]}),`\n`,_jsx(Heading,{level:`3`,id:`exemplo`,children:`Exemplo`}),`\n`,_jsx(_components.p,{children:`Pacote 40×30×30 cm, 2 kg real:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Peso cubado: `,_jsx(_components.code,{children:`(40 × 30 × 30) ÷ 6000 = 6 kg`})]}),`\n`,_jsxs(_components.li,{children:[`Correios cobra por `,_jsx(_components.strong,{children:`6 kg`}),` (peso cubado)`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`Pacote 20×15×10 cm, 3 kg real:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`Peso cubado: `,_jsx(_components.code,{children:`(20 × 15 × 10) ÷ 6000 = 0,5 kg`})]}),`\n`,_jsxs(_components.li,{children:[`Correios cobra por `,_jsx(_components.strong,{children:`3 kg`}),` (peso real)`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`limites-dos-correios`,children:`Limites dos Correios`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Serviço`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Peso máx.`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Dimensão máx.`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Valor máx.`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`SEDEX`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`left`},children:`30 kg`}),_jsx(_components.td,{style:{textAlign:`left`},children:`100 cm (maior lado)`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`left`},children:`R$ 10.000`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`PAC`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`left`},children:`30 kg`}),_jsx(_components.td,{style:{textAlign:`left`},children:`100 cm (maior lado)`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`left`},children:`R$ 3.000`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Mini Envios`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`left`},children:`2 kg`}),_jsx(_components.td,{style:{textAlign:`left`},children:`30×20×10 cm`}),_jsx(_components.td,{\"data-numeric\":`true`,style:{textAlign:`left`},children:`R$ 500`})]})]})]}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`O BulkRoute valida automaticamente esses limites nas cotações. Se um item exceder o limite, o Correios é descartado da cotação e o log explica o motivo.`})}),`\n`,_jsx(Heading,{level:`2`,id:`etiquetas`,children:`Etiquetas`}),`\n`,_jsx(_components.p,{children:`Os Correios fornecem etiqueta própria via API. O BulkRoute gera automaticamente no formato:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`PDF A4`}),` (4 etiquetas por folha — padrão SARA)`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`ZPL 100×150mm`}),` (impressora térmica — formato compatível com SARA)`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`A etiqueta inclui:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Código de rastreio (SSCC)`}),`\n`,_jsx(_components.li,{children:`Código de barras 128`}),`\n`,_jsx(_components.li,{children:`QR Code de validação`}),`\n`,_jsx(_components.li,{children:`Dados do remetente e destinatário`}),`\n`,_jsx(_components.li,{children:`Serviço contratado (SEDEX/PAC/Mini)`}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`rastreamento`,children:`Rastreamento`}),`\n`,_jsx(_components.p,{children:`O BulkRoute rastreia via a API CWS de rastreio:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Polling a cada 15 minutos`}),` (os Correios não enviam webhook)`]}),`\n`,_jsx(_components.li,{children:`Eventos normalizados para o padrão BulkRoute`}),`\n`,_jsxs(_components.li,{children:[`Status `,_jsx(_components.code,{children:`DELIVERED`}),` confirmado via evento “Entrega Efetuada”`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`eventos-comuns-dos-correios`,children:`Eventos comuns dos Correios`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Evento Correios`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Status BulkRoute`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Objeto postado`}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`PROCESSING`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Em trânsito`}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`IN_TRANSIT`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Saiu para entrega`}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`OUT_FOR_DELIVERY`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Entrega efetuada`}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`DELIVERED`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Tentativa de entrega`}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`FAILED`})})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Objeto devolvido`}),_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`RETURNED`})})]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`troubleshooting`,children:`Troubleshooting`}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{style:{textAlign:`left`},children:`Problema`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Causa`}),_jsx(_components.th,{style:{textAlign:`left`},children:`Solução`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`401 Unauthorized`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Código de acesso inválido`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Verificar credenciais no portal CWS`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`403 Forbidden`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Cartão de postagem sem saldo`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Recarregar cartão nos Correios`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:_jsx(_components.code,{children:`422 Validation Error`})}),_jsx(_components.td,{style:{textAlign:`left`},children:`Item excede limite do serviço`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Verificar peso/dimensões`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Cotação vazia`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Serviço não ativo no contrato`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Ativar serviço no BulkRoute`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{style:{textAlign:`left`},children:`Tracking não atualiza`}),_jsx(_components.td,{style:{textAlign:`left`},children:`API CWS instável`}),_jsx(_components.td,{style:{textAlign:`left`},children:`Aguardar próximo ciclo de polling`})]})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Configurando os Correios (CWS API)","description":"Conecte seu contrato dos Correios via nova API CWS para SEDEX, PAC e Mini Envios.","href":"/transportadoras/correios"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Credenciais Necessárias","slug":"credenciais-necessárias","depth":2,"children":[{"title":"Como obter","slug":"como-obter","depth":3,"children":[]}]},{"title":"Configuração no BulkRoute","slug":"configuração-no-bulkroute","depth":2,"children":[]},{"title":"Cubagem nos Correios","slug":"cubagem-nos-correios","depth":2,"children":[{"title":"Exemplo","slug":"exemplo","depth":3,"children":[]}]},{"title":"Limites dos Correios","slug":"limites-dos-correios","depth":2,"children":[]},{"title":"Etiquetas","slug":"etiquetas","depth":2,"children":[]},{"title":"Rastreamento","slug":"rastreamento","depth":2,"children":[{"title":"Eventos comuns dos Correios","slug":"eventos-comuns-dos-correios","depth":3,"children":[]}]},{"title":"Troubleshooting","slug":"troubleshooting","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"bulkroute","siteName":"BulkRoute Central de Ajuda","title":"Configurando os Correios (CWS API) - BulkRoute Central de Ajuda","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-09-08T20:04:29.964Z","originalFileLocation":"transportadoras/correios.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Conecte seu contrato dos Correios via nova API CWS para SEDEX, PAC e Mini Envios.\">\u003cmeta data-mint-head name=\"application-name\" content=\"BulkRoute Central de Ajuda\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bulkroute/QzBF_XssoisPy8WG/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/bulkroute/QzBF_XssoisPy8WG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bulkroute/QzBF_XssoisPy8WG/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bulkroute/QzBF_XssoisPy8WG/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bulkroute/QzBF_XssoisPy8WG/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/bulkroute/QzBF_XssoisPy8WG/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/bulkroute/QzBF_XssoisPy8WG/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/bulkroute/QzBF_XssoisPy8WG/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/bulkroute/QzBF_XssoisPy8WG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Configurando os Correios (CWS API) - BulkRoute Central de Ajuda\">\u003cmeta data-mint-head property=\"og:description\" content=\"Conecte seu contrato dos Correios via nova API CWS para SEDEX, PAC e Mini Envios.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"BulkRoute Central de Ajuda\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.bulkroute.com.br/transportadoras/correios\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://bulkroute.mintlify.app/_mintlify/api/og/v2?division=Conectando+Transportadoras\u0026amp;title=Configurando+os+Correios+%28CWS+API%29\u0026amp;description=Conecte+seu+contrato+dos+Correios+via+nova+API+CWS+para+SEDEX%2C+PAC+e+Mini+Envios.\u0026amp;theme=0c7dcfd3b6758027c3a449b0\u0026amp;signature=a27a3fff26df6d88a9ccf4aa128416ed98c91d7d35aac8d8f8dd1509cbf89c08\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Configurando os Correios (CWS API) - BulkRoute Central de Ajuda\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Conecte seu contrato dos Correios via nova API CWS para SEDEX, PAC e Mini Envios.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://bulkroute.mintlify.app/_mintlify/api/og/v2?division=Conectando+Transportadoras\u0026amp;title=Configurando+os+Correios+%28CWS+API%29\u0026amp;description=Conecte+seu+contrato+dos+Correios+via+nova+API+CWS+para+SEDEX%2C+PAC+e+Mini+Envios.\u0026amp;theme=0c7dcfd3b6758027c3a449b0\u0026amp;signature=a27a3fff26df6d88a9ccf4aa128416ed98c91d7d35aac8d8f8dd1509cbf89c08\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/bulkroute/QzBF_XssoisPy8WG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"BulkRoute Central de Ajuda\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#2563eb\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.bulkroute.com.br/transportadoras/correios\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/transportadoras/correios.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.bulkroute.com.br/#organization\",\"name\":\"BulkRoute Central de Ajuda\",\"url\":\"https://docs.bulkroute.com.br\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/bulkroute/3b7W0SLBzshYyGcU/images/logo-light.svg?fit=max\u0026auto=format\u0026n=3b7W0SLBzshYyGcU\u0026q=85\u0026s=0a9290ede9e4a8387b55515feeea5769\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.bulkroute.com.br#website\",\"name\":\"BulkRoute Central de Ajuda\",\"url\":\"https://docs.bulkroute.com.br\",\"publisher\":{\"@id\":\"https://docs.bulkroute.com.br/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.bulkroute.com.br/transportadoras/correios#webpage\",\"url\":\"https://docs.bulkroute.com.br/transportadoras/correios\",\"name\":\"Configurando os Correios (CWS API)\",\"description\":\"Conecte seu contrato dos Correios via nova API CWS para SEDEX, PAC e Mini Envios.\",\"dateModified\":\"2026-09-08T20:04:29.964Z\",\"isPartOf\":{\"@id\":\"https://docs.bulkroute.com.br#website\"},\"breadcrumb\":{\"@id\":\"https://docs.bulkroute.com.br/transportadoras/correios#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.bulkroute.com.br/transportadoras/correios#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Conectando Transportadoras\",\"item\":\"https://docs.bulkroute.com.br/transportadoras/overview\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Configurando os Correios (CWS API)\",\"item\":\"https://docs.bulkroute.com.br/transportadoras/correios\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.bulkroute.com.br/transportadoras/correios#article\",\"headline\":\"Configurando os Correios (CWS API)\",\"name\":\"Configurando os Correios (CWS API)\",\"description\":\"Conecte seu contrato dos Correios via nova API CWS para SEDEX, PAC e Mini Envios.\",\"url\":\"https://docs.bulkroute.com.br/transportadoras/correios\",\"mainEntityOfPage\":{\"@id\":\"https://docs.bulkroute.com.br/transportadoras/correios#webpage\"},\"dateModified\":\"2026-09-08T20:04:29.964Z\",\"publisher\":{\"@id\":\"https://docs.bulkroute.com.br/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.bulkroute.com.br#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"BulkRoute Central de Ajuda\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"BulkRoute Central de Ajuda","nav":{"global":null,"tabs":[{"tab":"Documentação","pages":[{"title":"Documentação","href":""}]},{"tab":"Painel Admin","pages":[{"title":"Painel Admin","href":"/painel-admin"}]},{"tab":"Transportadoras","groups":[{"group":"Conectando Transportadoras","pages":[{"title":"Visão Geral de Transportadoras","href":"/transportadoras/overview"},{"title":"Configurando a Braspress","href":"/transportadoras/braspress"},{"title":"Configurando o SSW Sistema de Transportes","href":"/transportadoras/ssw"},{"title":"Configurando a Jadlog","description":"Integração oficial com a API da Jadlog para cotação, coleta e emissão de etiquetas.","href":"/transportadoras/jadlog"},{"title":"Configurando os Correios (CWS API)","href":"/transportadoras/correios"},{"title":"Configurando Frota Própria \u0026 Motoristas","description":"Como despachar pedidos para veículos da sua empresa e motoristas usando o app PWA.","href":"/transportadoras/frota-propria"},{"title":"Importação de Tabelas em Planilha","href":"/transportadoras/planilha"}]}]},{"tab":"Integrações","pages":[{"title":"Integrações","href":"/integracoes/overview"}]},{"tab":"API \u0026 Integração","pages":[{"title":"API \u0026 Integração","href":"/api-reference/introduction"}]}]},"basePath":"","title":"Configurando os Correios (CWS API) - BulkRoute Central de Ajuda","buildId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","deploymentId":"dpl_9VVk5y1P8k1ATeJguVngy9Q3cmbD","dynamics":[],"chunks":[]}
