Modelo de Registro de Importação/Exportação Backend
Códigos HTS, Registros de Tarifas e Histórico de Entrada Aduaneira
Um backend de registro de importação/exportação pronto para produção em Back4app com códigos HTS, registros de tarifas e histórico de entrada aduaneira. Inclui diagrama ER, dicionário de dados, esquema JSON, playground da API e um prompt de Agente de IA para configuração rápida.
Principais Pontos para Operações de Registro
Este modelo fornece um backend de log de importação/exportação com códigos HTS, registros de impostos e histórico de entrada na alfândega para que a equipe de operações possa revisar entradas e remessas em um só lugar.
- Rastreamento de código HTS — Armazene linhas de HTSCode com números tarifários, descrições e notas de classificação específicas do país.
- Histórico de registros de imposto — Mantenha as entradas do registro de imposto vinculadas a remessas, números de entrada e valores avaliados.
- Histórico de entrada na alfândega — Revise registros de entrada por porto, corretor, data de arquivamento e status de liberação.
- Visibilidade de Remessas — Vincule as classes de Remessa e Entrada de Alfândega para que a equipe possa acompanhar cada importação ou exportação desde o arquivamento até a liberação.
Visão Geral: Registro de Importação/Exportação
No registro de importação/exportação, “geralmente fazemos assim” não é um controle — os passos documentados e os resultados capturados são. No Back4app, Remessa, Código HTS, Registro de Direito, Entrada de Alfândega e Nota de Auditoria se conectam em uma narrativa coerente de registro de importação/exportação em vez de uma pilha de bilhetes e arquivos desconectados. O esquema abrange Remessa (numeroRemessa, direção, portoOrigem, portoDestino), Código HTS (código, descrição, taxaDireito), Registro de Direito (remessa, códigoHts, valorDireito, avaliadoPor), Entrada de Alfândega (numeroEntrada, corretor, arquivadoEm, statusLiberação) e Nota de Auditoria (entrada, nota, autor) com acesso baseado em autenticação e funções integrado. Conecte seu frontend e comece a registrar a atividade alfandegária mais rápido.
Melhor para:
Como este backend de Log de importação/exportação está organizado
Equipes móveis e pessoal de escritório veem diferentes fatias da realidade no log de importação/exportação; o trabalho do produto é costurar essas fatias sem jogos de culpa.
Revise Shipment, HTSCode e DutyLog primeiro, depois abra um cartão de pilha para ver notas específicas do SDK e padrões de integração.
Recursos principais de log de importação/exportação
Cada cartão de tecnologia neste hub usa o mesmo esquema de log de importação/exportação com Shipment, HTSCode, DutyLog, CustomsEntry e AuditNote.
Rastreamento de remessa
A remessa armazena shipmentNo, direção, originPort, destinationPort e status.
Biblioteca de códigos HTS
HTSCode mantém os campos código, descrição, capítulo e taxa de imposto.
Entradas do registro de impostos
DutyLog vincula remessa, htsCode, valor do imposto e avaliadoPor.
Histórico de entradas na alfândega
CustomsEntry captura entryNo, broker, filedAt e releaseStatus.
Por que construir seu backend de Log de Importação/Exportação com Back4app?
Back4app dá à sua equipe primitivas de remessa, dever e entrada, para que o foco permaneça no trabalho de classificação e arquivamento em vez de tarefas de infraestrutura.
- •Dados de envio e arquivamento em um único modelo: As classes Shipment e CustomsEntry mantêm originPort, destinationPort, entryNo e releaseStatus interligados.
- •Visibilidade de tarifas e HTS: Os campos HTSCode e DutyLog, como código, taxa de imposto, valor do imposto e avaliado por, suportam tarefas de revisão e auditoria.
- •Atualizações de log em tempo real: Use Live Queries para acompanhar as mudanças em CustomsEntry enquanto mantém o REST e GraphQL disponíveis para ferramentas de despacho e relatórios.
Construa um backend de log que forneça aos gerentes e coordenadores o histórico de envio que eles precisam, sem reestruturar o esquema depois.
Benefícios principais
Um backend de log de importação/exportação que ajuda as equipes a revisar declarações mais rápido e manter os detalhes da remessa em um só lugar.
Revisão de classificação mais rápida
Use HTSCode.code e HTSCode.dutyRate para comparar itens sem ter que vasculhar planilhas.
Limpar rastros de dever
DutyLog.dutyAmount e DutyLog.assessedBy preservam quem calculou cada figura de dever.
Histórico de entrada mais limpo
CustomsEntry.entryNo, filedAt e releaseStatus facilitam responder perguntas sobre o status do escritório ou armazém.
Contexto de nível de envio
Shipment.shipmentNo e Shipment.direction mantêm registros de importação e exportação agrupados por rota.
Notas amigáveis à auditoria
AuditNote.note e AuditNote.author adicionam comentários de revisores a entradas específicas quando corretores ou gerentes solicitam contexto.
Bootstrap assistido por IA
Gere o esquema, regras de segurança e fluxo de API inicial com um único prompt estruturado.
Pronto para lançar seu aplicativo de log de importação/exportação?
Deixe o Agente de IA da Back4app estruturar seu backend de log de importação/exportação e gerar fluxos de trabalho de envio, imposto e entrada de alfândega a partir de um prompt.
Grátis para começar — 50 prompts do Agente de IA/mês, sem necessidade de cartão de crédito
Pilha Técnica
Tudo incluído neste modelo de backend de log de importação/exportação.
Diagrama ER de Envio e Aduana
Modelo de relacionamento de entidades para o esquema backend de registro de importação/exportação.
Esquema cobrindo envios, códigos HTS, registros de impostos, entradas aduaneiras e notas de auditoria.
Ver fonte do diagrama
erDiagram
User ||--o{ ImportBatch : "manager"
User ||--o{ DutyEntry : "enteredBy"
User ||--o{ CustomsHistory : "recordedBy"
ImportBatch ||--o{ DutyEntry : "importBatch"
ImportBatch ||--o{ CustomsHistory : "importBatch"
User {
String objectId PK
String username
String email
String password
String role
Date createdAt
Date updatedAt
}
ImportBatch {
String objectId PK
String batchNumber
String direction
String status
String portOfEntry
String managerId FK
Date createdAt
Date updatedAt
}
DutyEntry {
String objectId PK
String importBatchId FK
String htsCode
String goodsDescription
String countryOfOrigin
Number declaredValue
Number dutyAmount
String enteredById FK
Date createdAt
Date updatedAt
}
CustomsHistory {
String objectId PK
String importBatchId FK
String entryStatus
String entryNumber
Date recordedAt
String recordedById FK
Date createdAt
Date updatedAt
}
HtsCodeCatalog {
String objectId PK
String htsCode
String description
Number dutyRate
Date effectiveDate
Date createdAt
Date updatedAt
}
Fluxo de Integração Aduaneira
Fluxo de execução típico para login, consulta de remessas, registro de impostos e atualizações de entrada.
Ver fonte do diagrama
sequenceDiagram
participant User
participant App as Import/Export Log App
participant Back4app as Back4app Cloud
User->>App: Sign in
App->>Back4app: POST /login
Back4app-->>App: Session token
User->>App: Open import batches
App->>Back4app: GET /classes/ImportBatch?include=manager
Back4app-->>App: Batch list
User->>App: Add duty entry with HTS code
App->>Back4app: POST /classes/DutyEntry
Back4app-->>App: DutyEntry objectId
User->>App: Record customs history
App->>Back4app: POST /classes/CustomsHistory
Back4app-->>App: CustomsHistory objectId
App->>Back4app: GET /classes/HtsCodeCatalog?order=htsCode
Back4app-->>App: HTS code catalogDicionário de dados de log
Referência em nível de campo para cada classe no esquema de log de importação/exportação.
| Campo | Tipo | Descrição | Obrigatório |
|---|---|---|---|
| objectId | String | Auto-generated unique identifier | Auto |
| username | String | User login name | |
| String | User email address | ||
| password | String | Hashed password (write-only) | |
| role | String | Role of the user (e.g. manager, coordinator, field_staff) | |
| createdAt | Date | Auto-generated creation timestamp | Auto |
| updatedAt | Date | Auto-generated last-update timestamp | Auto |
7 campos em User
Segurança e Permissões
Como ACL e CLP protegem remessas, códigos HTS, registros de impostos, entradas de alfândega e notas de revisão.
Acesso ao log baseado em função
Apenas gerentes, coordenadores e funcionários aprovados podem editar linhas de Remessa, Registro de Imposto e Entrada de Alfândega.
Manutenção controlada de HTS
As entradas de HTSCode devem ser editáveis apenas por usuários que mantêm classificações ou aprovam alterações tarifárias.
Proteção de trilha de auditoria
Use regras de Cloud Code para que as alterações de AuditNote e DutyLog sejam validadas antes de salvar.
Esquema (JSON)
Definição do esquema JSON bruta pronta para copiar no Back4app ou usar como referência de implementação.
{
"classes": [
{
"className": "User",
"fields": {
"objectId": {
"type": "String",
"required": false
},
"username": {
"type": "String",
"required": true
},
"email": {
"type": "String",
"required": true
},
"password": {
"type": "String",
"required": true
},
"role": {
"type": "String",
"required": true
},
"createdAt": {
"type": "Date",
"required": false
},
"updatedAt": {
"type": "Date",
"required": false
}
}
},
{
"className": "ImportBatch",
"fields": {
"objectId": {
"type": "String",
"required": false
},
"batchNumber": {
"type": "String",
"required": true
},
"direction": {
"type": "String",
"required": true
},
"status": {
"type": "String",
"required": true
},
"portOfEntry": {
"type": "String",
"required": true
},
"manager": {
"type": "Pointer",
"required": true,
"targetClass": "User"
},
"createdAt": {
"type": "Date",
"required": false
},
"updatedAt": {
"type": "Date",
"required": false
}
}
},
{
"className": "DutyEntry",
"fields": {
"objectId": {
"type": "String",
"required": false
},
"importBatch": {
"type": "Pointer",
"required": true,
"targetClass": "ImportBatch"
},
"htsCode": {
"type": "String",
"required": true
},
"goodsDescription": {
"type": "String",
"required": true
},
"countryOfOrigin": {
"type": "String",
"required": true
},
"declaredValue": {
"type": "Number",
"required": true
},
"dutyAmount": {
"type": "Number",
"required": true
},
"enteredBy": {
"type": "Pointer",
"required": true,
"targetClass": "User"
},
"createdAt": {
"type": "Date",
"required": false
},
"updatedAt": {
"type": "Date",
"required": false
}
}
},
{
"className": "CustomsHistory",
"fields": {
"objectId": {
"type": "String",
"required": false
},
"importBatch": {
"type": "Pointer",
"required": true,
"targetClass": "ImportBatch"
},
"entryStatus": {
"type": "String",
"required": true
},
"entryNumber": {
"type": "String",
"required": true
},
"recordedAt": {
"type": "Date",
"required": true
},
"recordedBy": {
"type": "Pointer",
"required": true,
"targetClass": "User"
},
"createdAt": {
"type": "Date",
"required": false
},
"updatedAt": {
"type": "Date",
"required": false
}
}
},
{
"className": "HtsCodeCatalog",
"fields": {
"objectId": {
"type": "String",
"required": false
},
"htsCode": {
"type": "String",
"required": true
},
"description": {
"type": "String",
"required": true
},
"dutyRate": {
"type": "Number",
"required": true
},
"effectiveDate": {
"type": "Date",
"required": true
},
"createdAt": {
"type": "Date",
"required": false
},
"updatedAt": {
"type": "Date",
"required": false
}
}
}
]
}Construir com Agente de IA
Use o Agente de IA Back4app para gerar um aplicativo real de log de importação/exportação a partir deste modelo, incluindo fluxos de frontend, backend, autenticação, e envio, tarifas e entradas de alfândega.
Crie um backend de aplicativo de log de importação/exportação no Back4app com este esquema e comportamento exatos. Esquema: 1. Usuário (use o Back4app integrado): nome de usuário, e-mail, senha; objectId, createdAt, updatedAt (sistema). 2. Envio: shipmentNo (String, obrigatório), direction (String, obrigatório), originPort (String, obrigatório), destinationPort (String, obrigatório), status (String, obrigatório); objectId, createdAt, updatedAt (sistema). 3. HTSCode: code (String, obrigatório), description (String, obrigatório), chapter (String, obrigatório), dutyRate (Number, obrigatório); objectId, createdAt, updatedAt (sistema). 4. DutyLog: shipment (Pointer to Shipment, obrigatório), htsCode (Pointer to HTSCode, obrigatório), dutyAmount (Number, obrigatório), assessedBy (Pointer to User, obrigatório), assessedAt (Date, obrigatório); objectId, createdAt, updatedAt (sistema). 5. CustomsEntry: shipment (Pointer to Shipment, obrigatório), entryNo (String, obrigatório), broker (String, obrigatório), filedAt (Date, obrigatório), releaseStatus (String, obrigatório); objectId, createdAt, updatedAt (sistema). 6. AuditNote: entry (Pointer to CustomsEntry, obrigatório), note (String, obrigatório), author (Pointer to User, obrigatório), createdAtNote (Date, obrigatório); objectId, createdAt, updatedAt (sistema). Segurança: - Apenas gerentes e coordenadores autorizados podem editar envios, registros de tarifas e entradas de alfândega. Use Cloud Code para validação. Autenticação: - Cadastro, login, logout. Comportamento: - Listar envios, classificar códigos HTS, adicionar registros de tarifas, atualizar entradas de alfândega e anexar notas de auditoria. Entrega: - aplicativo Back4app com esquema, ACLs, CLPs; frontend para envios, códigos HTS, registros de tarifas, entradas de alfândega e notas.
Pressione o botão abaixo para abrir o Agente com este prompt de modelo pré-preenchido.
Este é o prompt base sem um sufixo de tecnologia. Você pode adaptar a pilha de frontend gerada depois.
API Playground
Experimente os endpoints REST e GraphQL contra o esquema de log de importação/exportação. As respostas usam dados simulados e não exigem uma conta Back4app.
Usa o mesmo esquema que este template.
Escolha Sua Tecnologia
Expanda cada cartão para ver como integrar Shipment, HTSCode e DutyLog com sua pilha escolhida.
Flutter Registro de Importação/Exportação do Backend
React Registro de Importação/Exportação do Backend
React Nativo Registro de Importação/Exportação do Backend
Next.js Registro de Importação/Exportação do Backend
JavaScript Registro de Importação/Exportação do Backend
Android Registro de Importação/Exportação do Backend
iOS Registro de Importação/Exportação do Backend
Vue Registro de Importação/Exportação do Backend
Angular Registro de Importação/Exportação do Backend
GraphQL Registro de Importação/Exportação do Backend
REST API Registro de Importação/Exportação do Backend
PHP Registro de Importação/Exportação do Backend
.NET Registro de Importação/Exportação do Backend
O Que Você Recebe com Cada Tecnologia
Cada stack usa o mesmo esquema de log de importação/exportação e contratos de API.
Estrutura de log de envio unificada para registro de importação/exportação
Gerencie Envio, HTSCode, DutyLog, CustomsEntry e AuditNote com um único modelo de dados.
Fluxos de trabalho de HTS e imposto para registro de importação/exportação
Classifique mercadorias, armazene cálculos de impostos e mantenha o histórico de arquivos anexado a cada entrada.
Histórico de entrada aduaneira para registro de importação/exportação
Revise números de entrada, corretores, datas de arquivamento e status de liberação em um só lugar.
Acesso ciente de funções em registro de importação/exportação
Defina quem pode visualizar ou editar registros de envio, registros de impostos e notas de auditoria.
REST/GraphQL APIs para registro de importação/exportação
Integre ferramentas web, móveis e de back-office com o mesmo contrato de backend.
Arquitetura de log extensível para registro de importação/exportação
Adicione exceções, resultados de inspeção ou detalhes do contêiner posteriormente, sem alterar o fluxo principal.
Comparação de Framework de Importação/Exportação
Compare a velocidade de configuração, estilo de SDK e suporte a IA entre todas as tecnologias suportadas.
| Framework | Tempo de Configuração | Benefício de Importação/Exportação | Tipo de SDK | Suporte de IA |
|---|---|---|---|---|
| Cerca de 5 min | Base de código única para logs de envio em dispositivos móveis e web. | SDK Tipado | Completo | |
| Menos de 5 minutos | Dashboard web rápido para histórico de entrada de alfândega. | SDK Tipado | Completo | |
| ~3–7 min | Aplicativo móvel multiplataforma para registros de deveres. | SDK Digitado | Completo | |
| Configuração rápida (5 min) | Aplicativo web renderizado no servidor para revisão de HTS. | SDK Digitado | Completo | |
| ~3–5 min | Integração web leve para registros de importação/exportação. | SDK Digitado | Completo | |
| Cerca de 5 min | Aplicativo nativo Android para atualizações de envio em campo. | SDK Digitado | Completo | |
| Menos de 5 minutos | Aplicativo nativo iOS para revisão de entrada da alfândega. | SDK Digitado | Completo | |
| ~3–7 min | Interface web Reactive para registros de envio. | SDK Digitado | Completo | |
| Configuração rápida (5 min) | Aplicativo web empresarial para rastreamento de deveres e HTS. | SDK Digitado | Completo | |
| Menos de 2 min | API flexível GraphQL para histórico de alfândega. | GraphQL API | Completo | |
| Configuração rápida (2 min) | Integração REST API para ferramentas de logística. | REST API | Completo | |
| ~3 min | Backend PHP no lado do servidor para logs de importação/exportação. | REST API | Completo | |
| ~3–7 min | .NET backend para fluxos de trabalho de envio e tarifas. | SDK Digitado | Completo |
O tempo de configuração reflete a duração esperada desde o início do projeto até a primeira consulta de Envio ou Entrada de Alfândega usando este esquema de modelo.
Perguntas Frequentes
Perguntas comuns sobre como construir um backend de registro de importação/exportação com este modelo.
Pronto para Construir Seu Aplicativo de Log de Importação/Exportação?
Inicie seu projeto de log de importação/exportação em minutos. Nenhum cartão de crédito necessário.