@hubcommerce/aras

Aras Kargo ESASWEB entegrasyonu — SetOrder (65 WSDL SOAP), GetQueryJSON/XML/DS ve kargo takip sayfası URL builder.

Yalnızca sunucu tarafında kullanın. Credential'ları istemciye veya repoya commit etmeyin.

Kurulum

npm install @hubcommerce/aras
# veya yerel path:
npm install file:../commerce-packages/cargo/aras

Ortam değişkenleri

.env.example dosyasına bakın. Credential blokları bağımsızdır (G2 gate):

| Blok | Değişkenler | Kullanım | |------|-------------|----------| | SetOrder | ARAS_SET_ORDER_USERNAME, ARAS_SET_ORDER_PASSWORD | 65 WSDL operasyonu (customerws) | | Query | ARAS_QUERY_USERNAME, ARAS_QUERY_PASSWORD, ARAS_QUERY_CUSTOMER_CODE | GetQuery* (customerservices) | | Tracking page | ARAS_TRACKING_PAGE_ACCOUNT_ID | URL builder (SOAP yok) |

Host matrisi (gate kilidi)

| Resource | Production | Test | |----------|------------|------| | dispatch | customerws.araskargo.com.tr/arascargoservice.asmx | customerservicestest.../ArasCargoService/arascargoservice.asmx | | query | customerservices.../ArasCargoIntegrationService.svc | customerservicestest.../ArasCargoIntegrationService.svc |

Detay: docs/OFFICIAL-ANSWERS.md

Kullanım (Faz 0)

import { createArasClient } from "@hubcommerce/aras";

const client = createArasClient({
  env: "test",
  setOrder: { username: process.env.ARAS_SET_ORDER_USERNAME!, password: process.env.ARAS_SET_ORDER_PASSWORD! },
  query: {
    username: process.env.ARAS_QUERY_USERNAME!,
    password: process.env.ARAS_QUERY_PASSWORD!,
    customerCode: process.env.ARAS_QUERY_CUSTOMER_CODE!,
  },
});

const probe = await client.testConnection();
// Faz 0: trackingPage-only → ok; SOAP credential → NOT_IMPLEMENTED stub

Geliştirme

npm run build --workspace=@hubcommerce/aras
npm test --workspace=@hubcommerce/aras
npm run test:exports --workspace=@hubcommerce/aras

Dokümantasyon

• CONFORMANCE.md — WSDL / QueryType checklist
• ADAPTER-CONTRACT.md — SDK vs adapter sınırı
• QA.md — Smoke ve manuel doğrulama
• MIGRATION.md — Sürüm geçişi ve WSDL drift
• VERSIONING.md — SemVer kuralları
• OFFICIAL-ANSWERS.md — Portal gate G1–G8
• DOC-SOURCES.md — Resmi kaynaklar

Ortak kurallar: docs/PACKAGE-CONVENTIONS.md