The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

Parse::SAMGov::Exclusion - defines the SAM Exclusions object

VERSION

version 0.102

SYNOPSIS

    my $exclusion = Parse::SAMGov::Exclusion->new;
    $exclusion->classification("firm");
    $exclusion->DUNS('123456789');
    $exclusion->CAGE('7ABZ1');

    ...

METHODS

new

This method creates a new Exclusion object.

classification

Identifies the exclusion Classification Type as either a Firm, Individual, Special Entity Designation, or Vessel. The maximum length of this field is 50 characters.

name

This sets/gets an object of Parse::SAMGov::Exclusion::Name which can hold either the entity name being excluded or the individual name being excluded.

address

This sets/gets an object of Parse::SAMGov::Entity::Address which holds the primary address of the entity or individual being excluded. It includes the city, two character abbreviation of state/province, three character abbreviation of country and a 10 character zip/postal code.

DUNS

This holds the unique identifier of the excluded entity, currently the Data Universal Numbering System (DUNS) number. Exclusion records with a classification type of Firm must have a DUNS number. It may be found in exclusion records of other classification types if the individual, special entity or vessel has a DUNS number. This has a maximum length of 9 characters.

xprogram

Exclusion Program identifies if the exclusion is Reciprocal, Nonreciprocal or Procurement. For any exclusion record created on or after August 25, 1995, the value will always be Reciprocal.

agency

Exclusion Agency identifies the agency which created the exclusion.

CT_code

This identifies the legacy Excluded Parties List System (EPLS) Cause & Treatment (CT) Code associated with the exclusion. CT Codes were replayed by the Exclusion Type in SAM. Exclusions created after August 2012 will not have CT Codes. They will only have Exclusion Types.

xtype

This identifies the Exclusion Type for the record replacing the CT Code. Exclusion Type is a simplified, easier to understand way to identify why the entity is being excluded.

comments

This field provides the agency creating the exclusion space to enter additional information as necessary. The maximum length allowed is 4000 characters.

active_date

This field identifies the date the exclusion went active. It returns a DateTime object. It accepts an input of the format MM/DD/YYYY, and converts it to a DateTime object with the timezone used as America/New_York.

termination_date

This field identifies the date the exclusion will be terminated. The date '12/31/2200' is denoted as indefinite exclusion for now. This field also returns a DateTime object.

record_status

This identifies the record as begin Active or Inactive. This can be blank if the record is active.

crossref

Identifies other names/aliases with which the entity being excluded has been identified. For example, companies who do business under other names may have those other names listed here.

SAM_number

The internal number used by SAM to identify exclusion records. Since only Firm exclusion records are required to have a DUNS number, SAM needed a way to uniquely track exclusion records of other classification types.

CAGE

The CAGE code associated with the excluded entity. Mostly found on Firm exclusion records, but could be in other types if the Individual, Special Entity, or Vessel has a CAGE code.

NPI

The National Provider Identifier (NPI) associated with the exclusion. Healthcare providers acquire their unique 10-digit NPIs from the Centers for Medicare & Medicaid Services (CMS) at the Department of Health & Human Services (HHS) to identify themselves in a standard way throughout their industry.

AUTHOR

Vikas N Kumar <vikas@cpan.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2016 by Selective Intellect LLC.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.