NAME
Parse::SAMGov::Exclusion - defines the SAM Exclusions object
VERSION
version 0.201
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.
dnb_open_data
This flag denotes whether this is a D&B Open Data or not. V2 only.
UEI
This holds the SAM Unique Entity Identifier (UEI) and is 12 characters long. This number is only valid for V2 files on or after 2022.
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.
creation_date
This field identifies the date the exclusion was created in SAM. 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.
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) 2023 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.