Gift > Gift (Batch) endpoint: All or none?

Steven Lopresti · September 5

Hi,

We have a question about the Gift (Batch) endpoint in the RE NXT Gift API to add gifts to an existing batch: https://developer.sky.blackbaud.com/api#api=58bdd5edd7dcde06046081d6&operation=AddGiftsToBatch

Can we rely on either all of the gifts making their way to the batch or none at all? Or, is there a chance that only part of the gifts sent via this endpoint make it to the batch?

Basically, we want to know if we can depend on it fully, or if there's a chance that it partially fails us due to an unforeseen circumstance.

Thank you!

Alex Wong · September 8

I'm not sure if you are looking at this from a networking perspective or programming prospective. I do not want to get too "deep" into the conversation. As there are some amount of guarantee on various level of networking to ensure "retry" and "error handling" on each layer. So being concern some data is sent and not others shouldn't be concern of the app developer, as a "final fail" will indicate there is problem is transmitting the "whole data package".

In nutshell, if the API you are invoking did not return an error code, you can expect your full package of JSON has been received.

Alex Wong · September 5

I don't think there wouldn't be a "unknown" situation. If your api call will fail error code if there is issue.

You can try this pretty easily, make a call with 2 gifts in an array, first is good, 2nd is not (bad data)

Steven Lopresti · September 8

We were more concerned about an interruption midway that resulted in only some of the gifts making their way to RE NXT and the others being left behind.

Sending gifts with bad data (e.g., invalid constituent ID) results in RE NXT flagging them as exceptions to be resolved before approving the batch, which is good.

Gift > Gift (Batch) endpoint: All or none?

Best Answer

Answers

Categories