Download the PHP package justinbusschau/hmrc-gift-aid without Composer

On this page you can find all versions of the php package justinbusschau/hmrc-gift-aid. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package hmrc-gift-aid

HMRC (Gift Aid) Charity Repayment Claims

A library for charities and CASCs to claim Gift Aid (including Small Donations) from HMRC

Build Status Latest Stable Version Total Downloads License

'Gift Aid' is a UK tax incentive that enables tax-effective giving by individuals to charities in the United Kingdom. Gift Aid increases the value of donations to charities and Community Amateur Sports Clubs (CASCs) by allowing them to reclaim basic rate tax on a donor's gift.

'HMRC Charity Repayment Claims' is a library for submitting Gift Aid claims to HMRC.

Installation

The library can be installed via Composer. To install, simply add it to your composer.json file:

And run composer to update your dependencies:

$ curl -s http://getcomposer.org/installer | php $ php composer.phar update

Some notes on the library and Data Persistance

From the introduction to the IRMark Specification:

There is legislation in place that states that in the case of a civil dispute between the Inland Revenue (IR) and a taxpayer with regards to an Internet online submission, the submission held by the Inland Revenue is presumed to be correct unless the taxpayer can prove otherwise. In other words the burden of proof is on the taxpayer. There is therefore a requirement to enable the IR Online services and software that uses the services to provide a mechanism to aid a taxpayer to prove whether or not the submission held by IR is indeed the submission they sent.

That is a very roundabout way of saying the XML that you submit must include a signiture of some sort. The signature can be used to prove that what the HMRC received is actually what you intended to send. HMRC will, in their turn, include a similar signiture in any responses they send to you. In the case of submissions to the HMRC Government Gateway, this signature is the IRmark (pronounced IR Mark).

It is strongly recommended that both the XML that you send and the XML that you receive should be stored in case there is any dispute over the claim - be that a dispute over the submission of the claim or over the content of the claim itself.

This library will generate the appropriate IRmark signature for all outgoing messages and check the IRmark on all incoming messages. This library, however, does not attempt to store or in any way persist any data whatsoever. This means that your application will need to store a number of pieces of information for use during dispute resolution. Having said that, it is not necessary to store ALL messages sent to or received from the gateway. The following is a recommended set of data to be stored by your application.

See the sample source code below to see how and where to extract the above data from the library.

Basic Usage

Preparing your data

The first thing you need is to identify both the organisation(s) and the individual submitting the Gift Aid claim.

The Vendor data identifies the company and software product used to submit the claims. Each vendor is assigned a Vendor ID and is required to identify the software that will submit the claims. To obtain an ID, please see the Charities Online Service Recognition Process.

The Authorised Official is an individual within the organisation (Charity or CASC) that has been previously identified to HMRC as having the authority to submit claims on behalf of the organisation. That individual will register for an account to log in to Charities Online and the user ID and password are required when submitting claims. The additional data sent with the claim - name and contact details - must be consistent with that held by HMRC.

Each Charity or CASC that is registered with HMRC will have two identifiers. The first is the Charity ID which is a number issued by HMRC when registering as a charity. The second is the Charities Commission Reference which is issued by the relevant charity regulator. We also need to know which regulator the charity is registered with.

Finally, you will need to build a list of all donations for which you want to claim a Gift Aid repayment. For each donation you will also need to know the name and last known address of the donor.

And now that you have all the data you need, you can submit a claim.

Preparing to send a request

This applies to all cases below. Whenever you need to send something to HMRC you will need to prepare the gaService object as shown here.

Submitting a new claim

Once you have prepared the gaService object and collected your donations and donor data, you are ready to send the claim.

Submitting adjustments with a claim

If you submit a claim and then subsequently need to reverse or refund a donation for which you have already claimed Gift Aid, you will need to submit an adjustment with your next claim. The adjustment value is set to the value of the refund you have already been paid for the refunded donation. In other words if you claim Gift Aid on a £100.00 donation you will be paid £25.00 by HMRC. If you subsequently refund that £100.00 you submit an adjustment to HMRC for the £25.00.

Prepare the gaService object and your claim items as usual, but before calling giftAidSubmit add the adjustment as shown below.

Querying a previously submitted claim

Prepare the gaService object in the usual way and then call requestClaimData. This will return a list of all previously submitted claims with status. It's a good idea to delete older claim records - if nothing else it prevents having to download them all every time you need to call requestClaimData.

More Information

For more information on the Gift Aid scheme as it applies to Charities and Community Amateur Sports Clubs, and for information on Online Claim Submission, please see the HMRC website.

For information on developing and testing using HMRC Document Submission Protocol, please see HMRC Software Developers.


All versions of hmrc-gift-aid with dependencies

PHP Build Version
Package Version
Requires php Version >=5.3.2
justinbusschau/php-govtalk Version ~0.2.1
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package justinbusschau/hmrc-gift-aid contains the following files

Loading the files please wait ....