Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update US Verification response fields #466

Merged
merged 4 commits into from
Oct 20, 2023
Merged
Show file tree
Hide file tree
Changes from 2 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -17,44 +17,51 @@ content:
addresses:
- id: us_ver_c7cb63d68f8d6
recipient: LOB.COM
primary_line: 210 KING ST STE 6100
primary_line: 210 KING ST
secondary_line: ""
urbanization: ""
last_line: SAN FRANCISCO CA 94107-1728
last_line: SAN FRANCISCO CA 94107-1702
deliverability: deliverable
valid_address: true
components:
primary_number: "185"
primary_number: "210"
street_predirection: ""
street_name: KING
street_suffix: ST
street_postdirection: ""
secondary_designator: STE
secondary_number: "6100"
secondary_designator: ""
secondary_number: ""
pmb_designator: ""
pmb_number: ""
extra_secondary_designator: ""
extra_secondary_number: ""
city: SAN FRANCISCO
state: CA
zip_code: "94107"
zip_code_plus_4: "1728"
zip_code_plus_4: "1702"
zip_code_type: standard
delivery_point_barcode: "941071728506"
address_type: commercial
record_type: highrise
record_type: street
default_building_address: false
county: SAN FRANCISCO
county_fips: "06075"
carrier_route: C001
carrier_route: C032
carrier_route_type: city_delivery
po_box_only_flag: "N"
latitude: 37.77597542841264
longitude: -122.3929557343685
deliverability_analysis:
dpv_confirmation: Y
dpv_cmra: N
dpv_vacant: N
dpv_active: Y
dpv_inactive_reason: ""
dpv_throwback: N
dpv_non_delivery_day_flag: N
dpv_non_delivery_day_values: ""
dpv_no_secure_location: N
dpv_door_not_accessible: N
dpv_footnotes:
- AA
- BB
Expand Down
88 changes: 88 additions & 0 deletions resources/us_verifications/models/deliverability_analysis.yml
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,12 @@ required:
- dpv_cmra
- dpv_vacant
- dpv_active
- dpv_inactive_reason
- dpv_throwback
- dpv_non_delivery_day_flag
- dpv_non_delivery_day_values
- dpv_no_secure_location
- dpv_door_not_accessible
- dpv_footnotes
- ews_match
- lacs_indicator
Expand Down Expand Up @@ -75,6 +81,88 @@ properties:
* `''` –– A DPV match is not made (`deliverability_analysis[dpv_confirmation]` is `N` or an empty string).
example: "Y"

dpv_inactive_reason:
type: string
enum:
- "01"
- "02"
- "03"
- "04"
- "05"
- "06"
- ""
description: |
Indicates the reason why an address is vacant or no longer receiving deliveries. Possible values are:
* `01` –– Address does not receive mail from the USPS directly, but is serviced by a drop address.
* `02` –– Address not yet deliverable.
* `03` –– A DPV match is not made (`deliverability_analysis[dpv_confirmation]` is `N` or an empty string).
* `04` –– Address is a College, Military Zone, or other type.
* `05` –– Address no longer receives deliveries.
* `06` –– Address is missing required secondary information.
* `''` –– A DPV match is not made or the address is active.
example: "06"

dpv_throwback:
type: string
enum:
- "Y"
- "N"
- ""
description: |
Indicates a street address for which mail is delivered to a PO Box. Possible values are:
* `Y` –– Address is a PO Box throwback delivery point.
* `N` –– Address is not a PO Box throwback delivery point.
* `''` –– A DPV match is not made (`deliverability_analysis[dpv_confirmation]` is `N` or an empty string).
example: "N"

dpv_non_delivery_day_flag:
type: string
enum:
- "Y"
- "N"
- ""
description: |
Indicates whether deliveries are not performed on one or more days of the week at an address. Possible values are:
* `Y` –– Mail delivery does not occur on some days of the week.
* `N` –– Mail delivery occurs every day of the week.
* `''` –– A DPV match is not made (`deliverability_analysis[dpv_confirmation]` is `N` or an empty string).
example: "N"

dpv_non_delivery_day_values:
type: string
description: |
Indicates days of the week (starting on Sunday) deliveries are not performed at an address. For example:
* `YNNNNNN` –– Mail delivery does not occur on Sunday's.
* `NYNNNYN` –– Mail delivery does not occur on Monday's or Friday's.
* `''` –– A DPV match is not made (`deliverability_analysis[dpv_confirmation]` is `N` or an empty string) or address receives mail every day of the week (`deliverability_analysis[dpv_non_delivery_day_flag]` is `N` or an empty string).
example: "YNNNNNN"

dpv_no_secure_location:
type: string
enum:
- "Y"
- "N"
- ""
description: |
Indicates packages to this address will not be left due to security concerns. Possible values are:
* `Y` –– Address does not have a secure mailbox.
* `N` –– Address has a secure mailbox.
* `''` –– A DPV match is not made (`deliverability_analysis[dpv_confirmation]` is `N` or an empty string).
example: "N"

dpv_door_not_accessible:
type: string
enum:
- "Y"
- "N"
- ""
description: |
Indicates the door of the address is not accessible for mail delivery. Possible values are:
* `Y` –– Door is not accessible.
* `N` –– Door is accessible.
* `''` –– A DPV match is not made (`deliverability_analysis[dpv_confirmation]` is `N` or an empty string).
example: "N"

dpv_footnotes:
type: array
description: >
Expand Down
10 changes: 10 additions & 0 deletions resources/us_verifications/models/us_components.yml
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,7 @@ required:
- county_fips
- carrier_route
- carrier_route_type
- po_box_only_flag

properties:
primary_number:
Expand Down Expand Up @@ -186,6 +187,15 @@ properties:
The type of `components[carrier_route]`. For more detailed information about
each carrier route type, see [US Verification Details](#tag/US-Verification-Types).

po_box_only_flag:
type: string
enum:
- "Y"
- "N"
- ""
description: |
Indicates the mailing facility for an address only supports PO Box deliveries and other forms of mail delivery are not available.

latitude:
type: number
format: float
Expand Down
32 changes: 23 additions & 9 deletions resources/us_verifications/responses/us_verifications.yml
Original file line number Diff line number Diff line change
Expand Up @@ -18,44 +18,51 @@ content:
value:
id: us_ver_c7cb63d68f8d6
recipient: LOB.COM
primary_line: 210 KING ST STE 6100
primary_line: 210 KING ST
secondary_line: ""
urbanization: ""
last_line: SAN FRANCISCO CA 94107-1728
last_line: SAN FRANCISCO CA 94107-1702
deliverability: deliverable
valid_address: true
components:
primary_number: "185"
primary_number: "210"
street_predirection: ""
street_name: KING
street_suffix: ST
street_postdirection: ""
secondary_designator: STE
secondary_number: "6100"
secondary_designator: ""
secondary_number: ""
pmb_designator: ""
pmb_number: ""
extra_secondary_designator: ""
extra_secondary_number: ""
city: SAN FRANCISCO
state: CA
zip_code: "94107"
zip_code_plus_4: "1728"
zip_code_plus_4: "1702"
zip_code_type: standard
delivery_point_barcode: "941071728506"
delivery_point_barcode: "941071702108"
address_type: commercial
record_type: highrise
record_type: street
default_building_address: false
county: SAN FRANCISCO
county_fips: "06075"
carrier_route: C001
carrier_route: C032
carrier_route_type: city_delivery
po_box_only_flag: N
latitude: 37.77597542841264
longitude: -122.3929557343685
deliverability_analysis:
dpv_confirmation: Y
dpv_cmra: N
dpv_vacant: N
dpv_active: Y
dpv_inactive_reason: ""
dpv_throwback: N
dpv_non_delivery_day_flag: N
dpv_non_delivery_day_values: ""
dpv_no_secure_location: N
dpv_door_not_accessible: N
dpv_footnotes:
- AA
- BB
Expand Down Expand Up @@ -102,13 +109,20 @@ content:
county_fips: "06075"
carrier_route: BOO2
carrier_route_type: po_box
po_box_only_flag: ""
latitude: 37.75971500260575
longitude: -122.69397561170017
deliverability_analysis:
dpv_confirmation: Y
dpv_cmra: N
dpv_vacant: N
dpv_active: Y
dpv_inactive_reason: ""
dpv_throwback: ""
dpv_non_delivery_day_flag: ""
dpv_non_delivery_day_values: ""
dpv_no_secure_location: ""
dpv_door_not_accessible: ""
dpv_footnotes:
- AA
- BB
Expand Down
Loading