@horizon-integrations/nifb-vrsync

Integracao com o Nucleo de Imoveis de Francisco Beltrao (NIFB) via feed XML no formato VRSync (padrao VivaReal/ZAP).

O que faz

• Baixa o XML do feed VRSync e parseia pra JSON (XmlDownloader)
• Converte do formato VRSync para o formato Horizon (convertVrSyncPropertyToHorizon)

Instalacao

pnpm add @horizon-integrations/nifb-vrsync

Uso rapido

import { XmlDownloader, convertVrSyncPropertyToHorizon } from "@horizon-integrations/nifb-vrsync"

// 1. Baixar e parsear o XML
const downloader = new XmlDownloader({
  xmlUrl: "https://sitedeimobiliarias.com.br/nifb/Si9dados/imonov",
  outputDir: "./data",
})
const result = await downloader.downloadAll()
// result: { downloadedItems: 160, errors: [] }

// 2. Converter cada listing
const horizonProperty = convertVrSyncPropertyToHorizon(listingXml)

Feed XML

| Info | Valor | |---|---| | URL | https://sitedeimobiliarias.com.br/nifb/Si9dados/imonov | | Formato | XML VRSync 1.0 | | Autenticacao | Nenhuma (URL publica) | | Total imoveis | ~160 | | Atualizacao | Diaria | | Tamanho | ~800 KB | | Source Key | nifb-vrsync-imoveis |

Mapeamento de campos

O conversor mapeia os campos VRSync para o formato Horizon:

| Campo Horizon | Origem VRSync | Transformacao | |---|---|---| | reference | ListingID | Prefixo NIFB-{id} | | title | Title | Direto | | description | Description | Direto | | operacao | TransactionType | For Sale -> venda, For Rent -> locacao | | tipo | PropertyType | Traducao EN -> PT-BR | | valor_venda | ListPrice | Direto (BRL) | | valor_locacao | RentalPrice | Direto (BRL) | | dormitorios | Bedrooms | Direto | | banheiros | Bathrooms | Direto | | vagas_garagem | Garage | Direto | | area_total | LotArea | Direto | | area_util | LivingArea | Direto | | endereco_* | Location/* | Cidade, bairro, CEP, lat/lng | | images | Media/Item | URLs das fotos |

Documentacao detalhada

• FICHA_TECNICA_INTEGRACAO.md — Ficha tecnica completa com mapeamento de todos os campos, cobertura e lacunas

Dependencias

• @horizon-js/property-domain-schema — Schema base de imoveis Horizon