4) Sincronização offline

Resposta esperada da API

Sucesso para produtor / produtor_funcionario (HTTP 200)

Para usuários do tipo produtor ou produtor_funcionario, a resposta mantém o padrão antigo com items e pendencias, limitado ao cliente vinculado ao device token.

{
  "success": true,
  "msg": "Sincronização offline realizada com sucesso.",
  "data": {
    "server_time": "2026-04-14 15:10:00",
    "device_id": 999,
    "cliente_id": 123,
    "account_type": "produtor",
    "last_sync_at": "2026-04-14 00:00:00",
    "ttl_qr_horas": 48,
    "versao_app": {
    "versao_instalada": "1.0.3",
    "versao_atual": "1.0.4",
    "atualizado": 0,
    "atualizacao_obrigatoria": 1,
    "observacao": "Atualização obrigatória para correção da sincronização offline."
    },
    "total": 1,
    "items": [
      {
        "qrcode_id": 10,
        "referencia": "KIT PEDIDO 1500",
        "qrcode": "KIT_ABC123",
        "tipo_conteudo": "kit_entrega",
        "nome_tabela": "pedidos",
        "id_tabela": 1500,
        "status": 1,
        "cliente_id": 123,
        "id_g10_participacao": 2,
        "updated_at": "2026-04-14 09:00:00",
        "total_pontos": 4,
        "centro": {
          "latitude": -21.864533055,
          "longitude": -47.499776985
        }
      }
    ],
    "total_pendencias": 0,
    "pendencias": []
  }
}

---

Sucesso para colaborador (HTTP 200)

Para usuários do tipo colaborador, a resposta deve vir separada em blocos: qrcodes, fazendas e geocercas.

{
  "success": true,
  "msg": "Sincronização offline realizada com sucesso.",
  "data": {
    "server_time": "2026-04-14 15:10:00",
    "device_id": 999,
    "cliente_id": 112,
    "account_type": "colaborador",
    "last_sync_at": "2026-04-14 00:00:00",
    "ttl_qr_horas": 48,

    "versao_app": {
    "versao_instalada": "1.0.3",
    "versao_atual": "1.0.4",
    "atualizado": 0,
    "atualizacao_obrigatoria": 1,
    "observacao": "Atualização obrigatória para correção da sincronização offline."
    },

    "qrcodes": [
      {
        "qrcode_id": 10,
        "referencia": "KIT PEDIDO 1500",
        "qrcode": "KIT_ABC123",
        "tipo_conteudo": "kit_entrega",
        "nome_tabela": "pedidos",
        "id_tabela": 1500,
        "status": 1,
        "cliente_id": 123,
        "id_g10_participacao": 2,
        "updated_at": "2026-04-14 09:00:00",
        "total_pontos": 4,
        "centro": {
          "latitude": -21.864533055,
          "longitude": -47.499776985
        }
      },
      {
        "qrcode_id": 18,
        "referencia": "Página Pública G10 - 02",
        "qrcode": "https://regenerag10.com.br/qrcode/cli_EXEMPLO123",
        "tipo_conteudo": "pagina_publica",
        "nome_tabela": "g10_participacoes",
        "id_tabela": 2,
        "status": 1,
        "cliente_id": 123,
        "id_g10_participacao": 2,
        "updated_at": "2026-04-14 09:30:00",
        "total_pontos": 4,
        "centro": {
          "latitude": -21.864533055,
          "longitude": -47.499776985
        }
      }
    ],

    "fazendas": [
      {
        "cliente_id": 123,
        "razao_social": "FAZENDA MODELO",
        "cidade": "Araras",
        "uf": "SP",
        "segmento": "Citros",
        "idade_pomar": "8",
        "variedade_planta": "Pera Rio",
        "porta_enxerto": "Swingle",
        "qtde_planta": 450,
        "capacidade_tanque": 2000,
        "qtde_tanque_aplic": 2,
        "qtde_planta_tanque": 225,
        "area_irrigada": 3.5,
        "plano_manejo": "Plano de manejo G10",
        "id_g10_participacao": 2,
        "unidade_referencia": "G10 - 02"
      }
    ],

    "geocercas": [
      {
        "id_geocerca": 7,
        "cliente_id": 123,
        "id_g10_participacao": 2,
        "descricao": "Talhão 9",
        "qtde_plantas_area_tratada": 450,
        "total_pontos": 4,
        "centro": {
          "latitude": -21.864533055,
          "longitude": -47.499776985
        },
        "poligonos": [
          {
            "latitude": -21.8645679,
            "longitude": -47.49966836,
            "ordem": 1
          },
          {
            "latitude": -21.86449821,
            "longitude": -47.49988561,
            "ordem": 2
          }
        ]
      }
    ]
  }
}

Bloco qrcodes

O bloco qrcodes contém todos os QR Codes ativos disponíveis para o contexto do usuário. Para colaboradores, pode conter QR Codes de várias fazendas G10.

Campo	Descrição
qrcode_id	ID interno do QR Code no ERP.
referencia	Descrição/referência do QR Code.
qrcode	Conteúdo lido pela câmera do app.
tipo_conteudo	Tipo operacional do QR Code, como kit_entrega, preparo_bio ou pagina_publica.
cliente_id	ID do cliente/fazenda vinculado ao QR Code.
id_g10_participacao	ID da participação G10 vinculada ao QR Code.
total_pontos	Total de pontos existentes na geocerca vinculada à participação G10.
centro	JSON com latitude e longitude aproximadas do centro da geocerca.

Bloco fazendas

O bloco fazendas contém os dados necessários para alimentar a tela já existente de dados da fazenda/geocerca no app.

Campo	Descrição
cliente_id	ID do cliente/fazenda.
razao_social	Razão social ou nome da fazenda.
cidade / uf	Cidade e estado da fazenda.
segmento	Segmento/cultura principal do cliente.
qtde_planta	Quantidade total de plantas cadastradas no cliente.
capacidade_tanque	Capacidade do tanque utilizado na aplicação.
qtde_tanque_aplic	Quantidade de tanques por aplicação.
qtde_planta_tanque	Quantidade de plantas atendidas por tanque.
area_irrigada	Área irrigada cadastrada para o cliente.
plano_manejo	Plano de manejo cadastrado para o cliente.
id_g10_participacao	ID da participação G10 vinculada ao cliente.
unidade_referencia	Identificação visual da unidade, exemplo: G10 - 02.

Bloco geocercas

O bloco geocercas contém os dados da área e o polígono que será exibido no mapa do aplicativo.

Bloco versao_app

O bloco versao_app informa ao aplicativo se a versão instalada no aparelho está atualizada em relação à versão ativa cadastrada no ERP.

Campo	Descrição
versao_instalada	Versão que o app informou no campo app_version.
versao_atual	Versão mais recente ativa cadastrada no ERP.
atualizado	Indica se o aparelho está atualizado. Usar 1 para atualizado e 0 para desatualizado.
atualizacao_obrigatoria	Indica se a atualização é obrigatória. Quando for 1 e o aparelho estiver desatualizado, o app deve bloquear o uso até a instalação da nova versão.
observacao	Texto explicativo cadastrado no ERP sobre a versão atual.

Erro (HTTP != 200)

A sincronização offline também valida o campo app_version. Se o app não enviar esse campo ou enviar em formato inválido, a API retorna erro e a sincronização não continua.

Erro: app_version não informado

{
  "success": false,
  "error": "missing_app_version",
  "msg": "app_version não informado.",
  "data": {}
}

Erro: app_version inválido

{
  "success": false,
  "error": "invalid_app_version",
  "msg": "app_version inválido. Use o formato 1.0.0.",
  "data": {}
}

Erro: last_sync_at inválido

{
  "success": false,
  "error": "invalid_last_sync_at",
  "msg": "last_sync_at inválido. Use YYYY-MM-DD ou YYYY-MM-DD HH:MM:SS.",
  "data": {}
}