• Noțiuni de bază
    • Salut Lume
    • Acreditări
    • Note de lansare
    • Actualizări ale codului de țară
    • Suite API la bord
    • Schimb de date
    • Nu-l găsesc?
  • Identitate corporativă
    • Meci
    • Curăță
    • Curăță, apoi Potrivește
    • De asemenea, denumit Small (până la 100 de companii) Procesare în serie/curățare.

      Informații despre

      Produs D&B Direct 2.0
      Codul (produsele) produsului CPCM_CM
      Opțiuni)Nici unul
      Monitorizare disponibilăNu
      InterfațăSĂPUN
      WSDLn/A
      Format (e)XML
      ServiciuTransactionalMiniBatch
      OperațiuneProcessBatch
      2.0
      Eliberarea inițială3 octombrie 2013

      Această caracteristică permite emiterea mai multor cereri de curățare și potrivire dintr-un singur apel API, utilizând serviciul tranzacțional Mini-Batch pentru a sprijini loturile de dimensiuni mici (mai puțin de 100 de companii).

      Nu au fost aduse modificări acestui strat de date de la lansarea inițială.

      Pornire rapidă pentru loturi mici

      Procesul pentru loturile mici necesită următorii pași:

      1. Pregătirea listei - această caracteristică folosește același format de solicitare ca o singură curățare/potrivire (în XML) concatenată într-o singură trimitere.
      2. Încărcări de listă - când sunteți gata să inițiați un lot, trimiteți lista (adică ProcessBatch) pentru procesare.
      3. Pregătiți-vă pentru rezultate - la fel ca lista inițială, rezultatele vor fi în același aspect/format ca singura curățare/potrivire (în XML) concatenată într-un singur rezultat.
      4. Descărcarea rezultatelor - deoarece această caracteristică este sincronă, răspunsul din cererea ProcessBatch va conține înregistrările curățate.

      Cerere de caracteristică

      IMPORTANT: Vă rugăm să consultați noua versiune de îmbunătățire a securității serviciilor online, începând cu 09 noiembrie 2020.

      Prezentare generală

      Lista detaliilor solicitării produsului este ambalată (într-unul din cele două formate), bazată pe 64 codificată și încorporată într-un apel tipic API D&B Direct. Formatele disponibile includ text (delimitat de virgule) sau XML.

      Pentru a pregăti lista de solicitări de produse utilizând XML, concatenați mai multe copii ale pachetului de detalii ale cererii de rezoluție a unei singure entități la cerere și introduceți în etichetele BatchCleanseMatchRequest înainte de codificare.

      Numărul maxim de solicitări de produse pentru această operațiune este de 100.

      Valoarea InputObjectDetail LayoutVersion ar trebui să se potrivească cu cea mai recentă versiune a serviciului companiei, așa cum se menționează pe pagina Rezoluție entitate unică la cerere.

      Dreptul la stratul de date

      Pentru clienții din S.U.A. și piețele canadiene, API-ul este furnizat pentru colecții specifice de produse, rapoarte și/sau caracteristici (denumite în mod colectiv straturi de date) pentru producție și utilizare de probă. Dreptul nu este necesar pentru testarea în mediul sandbox.

      • Această caracteristică este intitulată „Rezoluția unei singure entități la cerere” pentru clienții D&B Direct 2.0.

      Pentru clienții din piețele Marii Britanii, Irlandei, Belgiei, Olandei și Luxemburgului, API-ul este furnizat ca un set specific de straturi de date pentru producție, încercare și utilizarea sandbox-ului.

      • Acest strat de date special NU este inclus în suita D&B Direct Onboard.

      Specificație

      Excepție: Cererile pentru această operațiune trebuie trimise în XML formatează printr-o comandă POST indiferent de ObjectFormatTypeText valoare.

      Nume Caracteristici
      ProcessBatchRequest Agregat
      ProcessBatchRequest @ ServiceVersionNumber Atribut
      ProcessBatchRequest. BatchDetail Agregat, Necesar

      Înregistrează informațiile necesare procesării unei anumite cereri.

      Un număr atribuit de aplicația consumatoare (de exemplu, GIH) care este utilizat pentru a identifica în mod unic o cerere de lot.

      Data și ora la care a fost creat acest mesaj. Când mesajul provine de la un intermediar, cum ar fi un manager de flux de lucru sau un autobuz de servicii, aceasta este data și ora la care mesajul a fost trimis către sau din funcția D&B,

      Înregistrează informații specifice care sunt necesare pentru procesarea unei cereri de lot.

      Cod utilizat pentru a identifica în mod unic funcția comercială care trebuie îndeplinită (de exemplu, Potriviți, Curățați, Corelați și Curățați).

      Înregistrează informații despre intrarea în procesul Batch.

      Înregistrează sau deține fișierul propriu-zis (de exemplu, date, imagine, blob) stocat în atașament.

      Formatul obiectului de conținut (de exemplu: XML, CSV etc.)

      Numele aspectului pentru această colecție de înregistrări de date. De exemplu, numele aspectului „GBI” denotă aspectul Global Batch Input.

      Versiunea serviciului pentru solicitarea de bază.

      Înregistrează informații despre specificațiile de ieșire.

      Apel înapoi, FTP, coadă JMS, serviciu web

      Valoare posibilă (e): online

      Valoare (valori) posibile: XML

      Înregistrează date care permit clientului să specifice informații care să fie legate de cerere pentru a susține procesul ulterior.

      Un șir de referință de formă liberă furnizat de client pentru a fi legat de produs pentru a susține procesul ulterior.

      Punct final

      Utilizați următorul punct final pentru a solicita această caracteristică. Depinde de serviciul de bază care oferă răspunsul.

      Punct final (TransactionalMiniBatch)
      POST https://direct.dnb.com/V/TransactionalMiniBatch/Batches

      Testarea

      Această operațiune va returna un static set de rezultate în mediul de testare direct D&B (sandbox), indiferent de parametrii cererii.

      Răspuns la caracteristică

      Specificație

      Următoarea este o listă a câmpurilor de date posibile returnate de această operație în XML raspuns. Sunt furnizate eșantioane pentru testarea recuperării reușite și nereușite și pentru a demonstra aspectul de bază al unui răspuns. Este posibil ca datele returnate în eșantioane să nu reprezinte valorile reale pe care le va furniza această caracteristică.

      Atașamentul MTOM specificat în ContentObject este un câmp codificat base64 care, atunci când este decodat, va fi în formatul specificat de ObjectFormatTypeText.

      NOTĂ: Această operație va trimite înapoi un răspuns în XML, indiferent de ObjectFormatTypeText valoarea trimisă la cerere.

      Nume Caracteristici
      ProcessBatchResponse Agregat
      ProcessBatchResponse @ServiceVersionNumber Atribut
      ProcessBatchResponse. BatchDetail Agregat, Necesar

      Înregistrează informațiile necesare pentru returnarea unui anumit răspuns.

      Un număr atribuit de aplicația consumatoare (de exemplu, GIH) care este utilizat pentru a identifica în mod unic o cerere de lot.

      Un număr atribuit de serviciul compozit (de exemplu, MatchCleanseService, GHM) care este utilizat pentru a identifica în mod unic o cerere de lot.

      Înregistrează informații despre rezultatul procesului.

      Text care înregistrează criticitatea rezultatului, de exemplu, informații, avertisment, eroare, fatal.

      Un șir alfanumeric care identifică în mod unic rezultatul lotului.

      Text care explică rezultatul lotului.

      Un agregat care se poate repeta de mai multe ori pentru a înregistra date textuale care se extind pe ResultID și ResultText pentru a furniza utilizatorului informații suplimentare cu privire la starea lotului. Dacă starea implică că există o problemă, aceasta poate oferi, de asemenea, îndrumări utilizatorului cu privire la modul de abordare a acesteia.

      Text care descrie informații suplimentare cu privire la rezultatul lotului.

      Înregistrează informații despre rezultatul procesului Batch.

      Descrie formatul fișierului atașat, de exemplu, txt, pdf, html.

      Valori posibile: JSON; XML

      Numele aspectului pentru această colecție de înregistrări de date. De exemplu, numele aspectului „GBI” denotă aspectul Global Batch Input.

      Înregistrează sau deține fișierul propriu-zis (de exemplu, date, imagine, blob) stocat în atașament.

      Înregistrează informații despre timpul procesului și numărul de înregistrări procesate.

      Înregistrează informații despre timpul procesului și timpul de finalizare.

      Data și ora la care cererea de lot a fost creată de cererea de depunere.

      Data și ora la care cererea de lot a fost primită de serviciu.

      Data și ora când procesul solicitat (de exemplu, potrivire, curățare, curățare) a fost efectiv finalizat de către serviciu.

      Înregistrează informații despre numărul de înregistrări de intrare și ieșire și numărul de înregistrări care au trecut și au eșuat procesul solicitat.

      O valoare numerică care indică numărul total de înregistrări conținute în fișierul de intrare.

      O valoare numerică care indică numărul total de înregistrări conținute în fișierul de ieșire.

      O valoare numerică care indică numărul total de înregistrări care au trecut procesul solicitat.

      O valoare numerică care indică numărul total de înregistrări care nu au reușit procesul solicitat.

      Coduri de răspuns și gestionarea erorilor

      Solicitările de service reușite vor returna un cod de răspuns CM000 în câmpul BatchResult ResultID. În caz contrar, unul dintre codurile de răspuns standard D&B Direct va fi returnat.

      Această operațiune poate returna următoarele coduri de răspuns: CM002, CM004 și SC001-SC008.

      NOTĂ: Fiecare solicitare individuală va returna un cod de răspuns în câmpul GetCleanseMatchResponse TransactionResult ResultID. Consultați Rezoluția la o singură entitate la cerere pentru o listă de coduri de răspuns valide.

      Cererile API D&B Direct 2.0 sunt furnizate pe o bază măsurată; și poate necesita drepturi înainte de a fi utilizate în mediul de producție. În plus, o limită de concurență (QPS) este monitorizată pentru a se asigura că nu este depășită. Un cod de eroare va fi returnat în cazul în care o tranzacție este limitată.

      Utilizarea calificată (de exemplu, un răspuns reușit) este urmărită și facturată în conformitate cu termenii și condițiile contractului clientului. Codurile de răspuns CM000, CM010, PD002 și PD015 sunt considerate reușite. Există o funcție încorporată pentru a preveni facturarea duplicat atunci când sunt trimise mai multe cereri de succes cu aceleași criterii în aceeași zi calendaristică (care se bazează pe ora standard de est [GMT-5]).

      Detaliile de utilizare pentru o cerere de lot mic sunt înregistrate ca o serie de cereri individuale de tipul cererii de bază. Prin urmare, rapoartele privind utilizarea online a clienților (OLUS) vor afișa mai multe intrări pentru fiecare lot trimis.

      Note despre caracteristici

      Rezultatele acestei funcții vor fi un bloc concatenat codat de bază 64 de răspunsuri separate la rezoluție la o singură entitate la cerere (pe baza formatului specificat la cerere).

      Această caracteristică poate face mai multe încercări de localizare a numărului D-U-N-S, utilizând inițial criteriile de intrare curățate. Dacă nu este localizată o potrivire de încredere ridicată, va fi efectuată o căutare ulterioară utilizând criteriile de introducere inițiale, iar rezultatele ambelor încercări vor fi combinate și sortate pentru a oferi cele mai mari potriviri de încredere disponibile...

      Atunci când este furnizată o adresă cu mai multe linii (de exemplu, numărul clădirii, numele străzii și caseta poștală într-o singură cerere), această caracteristică va returna adresa corectă în scopuri poștale.

      Codurile de răspuns vor fi returnate pentru rezultatul general, precum și pentru fiecare solicitare individuală de produs.