Abgleich einer Carrier-Bulk-Aufgabenreservierung mit der endgültigen Belastung

Ein lokaler Abgleichsdatensatz verbindet eine Carrier-Bulk-Aufgabe mit ihrer Datei, den Endergebnissen und den Wallet-Beobachtungen, ohne bei gleichzeitigem Verbrauch raten zu müssen.

Für den Abgleich des Guthabens bei Carrier-Bulk-Aufgaben trennen Sie die geschätzte Reservierung von der endgültigen Belastung und der nicht genutzten Reserve. Ordnen Sie die Aufgabe der vorbereiteten Datei und den abgeschlossenen Ergebnissen zu und prüfen Sie anschließend, ob andere Aktivitäten das gemeinsam genutzte Kontoguthaben beeinflusst haben.

Betrachten Sie die Reservierung als laufende Arbeit

Sie übermitteln eine Carrier-Datei, sehen, wie das verfügbare Guthaben sinkt, und erhalten später eine CSV-Datei mit weniger Zeilen als beim ursprünglichen Upload. Die erste Kontobewegung allein verrät Ihnen noch nicht die endgültigen Kosten der Aufgabe. Die Bulk-Übermittlung reserviert einen geschätzten Betrag, während die Aufgabe verarbeitet wird.

CarrierLookup berechnet Nummern, die Ergebnisse liefern, und erstattet nicht genutzte Reserven an dasselbe Wallet zurück. Eine Aufgabe, die während der Vorbereitung fehlschlägt, gibt ihre Reservierung vollständig zurück. Dieser Abgleich der Reserve unterscheidet sich von der Stornierung einer Aufladung oder eines Paketkaufs.

Halten Sie drei Werte in Ihrem eigenen Datensatz getrennt: den reservierten Betrag, die endgültige Belastung und den freigegebenen Betrag. Wenn alle drei Werte für dieselbe Aufgabe verfügbar sind, lautet die erwartete Beziehung: Reservierung entspricht endgültiger Belastung plus freigegebener Reserve. Füllen Sie einen nicht verfügbaren Wert auf Aufgabenebene nicht mit einer Differenz des Gesamtkontostands auf, nur um diese Gleichung zu erfüllen.

Erstellen Sie den Aufgabendatensatz aus der übermittelten Datei

Beginnen Sie mit der exakten Datei, die Sie übermittelt haben, nicht mit der aktuellen Version einer Tabelle, die möglicherweise nachträglich bearbeitet wurde. Speichern Sie einen Datei-Hash, das ausgewählte Land, den Diensttyp carrier_batch, die Aufgaben-ID und die Übermittlungszeit. Bewahren Sie Dateien mit Kontaktinformationen in einem geschützten Speicher auf und verwenden Sie in Ihrem Arbeitsblatt Verweise darauf.

Die Bulk-Vorbereitung schließt ungültige Zeilen, Duplikate, Nummern ohne Ländervorwahl und Nummern außerhalb des ausgewählten Landes aus. Ausgeschlossene Zeilen werden nicht berechnet. Ihr lokaler Vorbereitungsbericht kann einige Ausschlüsse erklären, aber unterscheiden Sie Ihre Schätzung von den tatsächlich vom Dienst gemeldeten Zahlen.

Dies sind Felder in Ihrem Arbeitsblatt, kein versprochenes API-Abrechnungsbuch des Anbieters. Bewahren Sie die Quelle jedes Betrags auf, damit ein Mitarbeiter einen beobachteten Wert von einer Berechnung unterscheiden kann.

Zählen Sie abgeschlossene Ergebnisse, ohne Leerstellen als Fehler zu behandeln

Eine erfolgreiche Carrier-Aufgabe liefert eine CSV-Datei mit identifier, carrier, underlying_carrier, number_type, country_code, region und city. Verwenden Sie die Identifikatoren, um die Ausgabezeilen mit der vorbereiteten Eingabe zu verknüpfen. Die Bulk-CSV enthält nicht das Feld exists der synchronen Multi-Antwort.

Ein leerer Carrier- oder Geografiewert bedeutet, dass der Wert nicht verfügbar war. Dies ist kein ausreichender Beweis dafür, dass die Zeile fehlgeschlagen ist oder kostenlos sein sollte. Abgeschlossene Carrier-Ergebnisse können kostenpflichtig sein, auch wenn die Zuordnungsfelder leer sind. Halten Sie die Vollständigkeit der Felder bei der Kostenschätzung von der Anzahl der abgeschlossenen Ergebnisse getrennt.

Ihr lokaler Bericht könnte beispielsweise einige doppelte Eingabezeilen und einige abgeschlossene Ausgabezeilen mit leeren Stadt-Werten zeigen. Die doppelten Eingabezeilen gehören in den Abgleich der Vorverarbeitung. Die leeren Städte gehören in die Überprüfung der Ergebnisqualität. Beide Gruppen von der abrechenbaren Anzahl abzuziehen, würde zwei verschiedene Fragen vermischen.

Zählen Sie Identifikatoren konsistent und prüfen Sie doppelte oder fehlende Ausgabe-Mappings, bevor Sie Summen berechnen. Wenn die verfügbaren Aufgabendetails nicht belegen, warum ein übermittelter Identifikator fehlt, kennzeichnen Sie die Differenz als nicht aufgelöst. Erfinden Sie keinen Fehlercode pro Nummer aus dem Fehlen einer CSV-Zeile. Verwenden Sie den Aufgabenstatus und die verfügbaren Dienstnachweise, um dies zu klären.

Verwenden Sie ein ruhiges Wallet, um eine Aufgabe zu verstehen

Pausieren Sie bei einem isolierten Durchlauf andere kostenpflichtige Arbeiten unter Ihrer Kontrolle und notieren Sie das Guthaben unmittelbar vor der Übermittlung. Zeichnen Sie die Reservierungsbeobachtung auf, warten Sie auf den Endstatus der Aufgabe und notieren Sie das abgerechnete Guthaben sowie jede angezeigte Belastung oder Freigabe. Beziehen Sie Aufladungen, Paketänderungen und andere Kontobewegungen in den Beobachtungszeitraum ein.

Wenn es tatsächlich keine anderen Bewegungen gab, kann die Differenz zwischen dem Start- und dem Endguthaben die Nettokosten der Aufgabe bestätigen. Es ist dennoch hilfreich, dieses Ergebnis mit der Anzahl der abgeschlossenen Ergebnisse und dem geltenden Preis in der CarrierLookup-Preisübersicht zu vergleichen. Bewahren Sie den zum Zeitpunkt der Nutzung gültigen Preis auf, anstatt ihn stillschweigend durch einen späteren Preis zu ersetzen.

GET /api/v1/balance liest den aktuellen balance_micros-Wert, ohne eine Prüfung zu erstellen oder die Anfrage zu berechnen. Speichern Sie diese Ganzzahl direkt und verwenden Sie Ganzzahl-Arithmetik für Differenzen; konvertieren Sie den Betrag erst am Ende Ihrer Anwendung in einen Anzeige-Betrag. Ein Kontostand-Snapshot ist eine Kontobeobachtung, keine detaillierte Aufgabenabrechnung.

Die Aufgabe kann den Status processing, success oder failed haben. Eine in Bearbeitung befindliche Aufgabe ist nicht allein dadurch abgeschlossen, dass ein Kontostand unverändert blieb. Fragen Sie den Aufgabenstatus nicht häufiger als alle 30 Sekunden ab und bewahren Sie den Endstatus zusammen mit dem Ergebnisdatensatz auf.

Erklären Sie gleichzeitige Ausgaben, ohne sie der Datei zuzuordnen

Echtzeit-Carrier-Prüfungen und die asynchronen Dienste teilen sich ein Guthaben. Wenn ein anderes Team Prüfungen durchführt, während Ihre Bulk-Aufgabe läuft, enthält die Differenz zwischen Anfangs- und Endguthaben auch diese Arbeit. Eine andere Bulk-Reservierung kann am Ende des Zeitraums ebenfalls offen bleiben, wodurch das verfügbare Guthaben ein ungenauer Indikator für abgerechnete Kosten ist.

Trennen Sie in Ihrem Arbeitsblatt die aufgabenbezogenen Beträge von den kontoweiten Bewegungen. Gleichen Sie bekannte andere Belastungen, Gutschriften und ausstehende Reserven anhand der tatsächlich vorliegenden Nachweise ab. Wenn der Restbetrag nicht zugeordnet werden kann, melden Sie eine „nicht zugeordnete Differenz im geteilten Wallet“ zusammen mit dem Beobachtungsfenster. Ordnen Sie diese nicht der Aufgabe zu, die zuletzt abgeschlossen wurde.

Sammeln Sie bei einer unerklärlichen Differenz die Aufgaben-ID, den Diensttyp, Zeitstempel, Datei-Hash, die vorbereitete Anzahl, den Endstatus, die Ergebnisanzahl, Guthabenbeobachtungen sowie alle verfügbaren Reservierungs- oder Abrechnungsdetails. Geben Sie an, ob Echtzeit-Arbeiten oder andere Dateiaufgaben gleichzeitig ausgeführt wurden. Geben Sie nur die minimal notwendigen Kontaktdaten über den entsprechenden Support-Kanal weiter; fügen Sie niemals einen API-Schlüssel hinzu.

Beginnen Sie mit der nächsten Carrier-Bulk-Aufgabe: Halten Sie die Eingabeversion und die Aufgaben-ID vor der Übermittlung zusammen. Dieser kleine Schritt macht die endgültige CSV-Datei, die freigegebene Reserve und jede verbleibende Diskrepanz für dieselbe Arbeit nachvollziehbar.

Mehr erfahren

Wählen Sie die Produktinformationen, die zum nächsten Schritt in Ihrem Arbeitsablauf passen.

• Produktdokumentation ansehen →
• Mit dem Team sprechen →