Створення та відправка «е-ТТН» документа (без створення чернетки)
Для роботи з цим методом користувач повинен бути авторизованим.
URL |
|
Метод запиту |
POST |
URL запиту |
/api/eds/doc/ettn/ttn/create_and_send?gln=9864065732327 |
URL параметри |
gln (обов’язково) String - GLN власної Компанії new_doc_uuid (опціонально) UUID - ідентифікатор створюваного документа (може передаватись і бути назначеним при створенні документа зі сторони Вашого клієнта) |
Headers |
|
Authorization |
SID - токен, отриманий при авторизації |
Content-Type |
application/xml |
REQUEST |
|
JSON Body |
В тілі запиту методу передається повне UAECMR тіло документа е-ТТН (з заповненим UaSignatureStorage та підписом/підписами) в xml форматі, наприклад: |
<UAECMR
xmlns:qdt="urn:un:unece:uncefact:data:standard:QualifiedDataType:103"
xmlns:ram="urn:un:unece:uncefact:data:standard:ReusableAggregateBusinessInformationEntity:103"
xmlns:uas="urn:ua:signatures:SignaturesExtensions:1"
xmlns:udt="urn:un:unece:uncefact:data:standard:UnqualifiedDataType:27">
<eCMR>
<ExchangedDocumentContext>
<ram:SpecifiedTransactionID>0</ram:SpecifiedTransactionID>
<ram:BusinessProcessSpecifiedDocumentContextParameter>
<ram:ID>urn:ua:e-transport.gov.ua:ettn:01</ram:ID>
</ram:BusinessProcessSpecifiedDocumentContextParameter>
<ram:GuidelineSpecifiedDocumentContextParameter>
<ram:ID>urn:ua:e-transport.gov.ua:ettn:01:generic:001</ram:ID>
</ram:GuidelineSpecifiedDocumentContextParameter>
</ExchangedDocumentContext>
<ExchangedDocument>
<ram:ID>test_3674_re-test_010</ram:ID>
<ram:IssueDateTime>
<udt:DateTime>2023-09-17T09:30:00.000Z</udt:DateTime>
</ram:IssueDateTime>
<ram:IncludedNote>
<ram:ContentCode listAgencyID="logistic_unit_number_with_logger">logistic number</ram:ContentCode>
<ram:Content>CZ</ram:Content>
</ram:IncludedNote>
<ram:IncludedNote>
<ram:ContentCode listAgencyID="gps_number">gps</ram:ContentCode>
<ram:Content>CZ</ram:Content>
</ram:IncludedNote>
<ram:IncludedNote>
<ram:ContentCode listAgencyID="logger_number">termologer number</ram:ContentCode>
<ram:Content>CZ</ram:Content>
</ram:IncludedNote>
<ram:IncludedNote>
<ram:ContentCode listAgencyID="reserve_number">reserve_number</ram:ContentCode>
<ram:Content>CZ</ram:Content>
</ram:IncludedNote>
<ram:IncludedNote>
<ram:ContentCode listAgencyID="comment">comment by CZ</ram:ContentCode>
<ram:Content>CZ</ram:Content>
</ram:IncludedNote>
<ram:IssueLogisticsLocation>
<ram:Name>Місце складання документу</ram:Name>
<ram:Description>test1</ram:Description>
</ram:IssueLogisticsLocation>
</ExchangedDocument>
<SpecifiedSupplyChainConsignment>
<ram:GrossWeightMeasure unitCode="KGM">555</ram:GrossWeightMeasure>
<ram:AssociatedInvoiceAmount currencyID="UAH">4690</ram:AssociatedInvoiceAmount>
<ram:ConsignmentItemQuantity>234</ram:ConsignmentItemQuantity>
<ram:ConsignorTradeParty>
<ram:ID schemeAgencyID="ЄДРПОУ">42453235</ram:ID>
<ram:Name>Володя Нова ГЛН</ram:Name>
<ram:RoleCode>CZ</ram:RoleCode>
<ram:PostalTradeAddress>
<ram:PostcodeCode>456464</ram:PostcodeCode>
<ram:StreetName>вул. Атом, буд. 1</ram:StreetName>
<ram:CityName>c. Річиця</ram:CityName>
<ram:CountryID>UA</ram:CountryID>
<ram:CountrySubDivisionName>Волинська обл. Ковельський р-н</ram:CountrySubDivisionName>
</ram:PostalTradeAddress>
<ram:SpecifiedGovernmentRegistration>
<ram:ID>9864065748076</ram:ID>
<ram:TypeCode>TRADEPARTY_GLN</ram:TypeCode>
</ram:SpecifiedGovernmentRegistration>
</ram:ConsignorTradeParty>
<ram:ConsigneeTradeParty>
<ram:ID schemeAgencyID="ЄДРПОУ">98084002</ram:ID>
<ram:Name>Мій Одержувач</ram:Name>
<ram:RoleCode>CN</ram:RoleCode>
<ram:PostalTradeAddress>
<ram:PostcodeCode>734532</ram:PostcodeCode>
<ram:StreetName>б.145, вул. Зелена</ram:StreetName>
<ram:CityName>c. Річиця</ram:CityName>
<ram:CountryID>UA</ram:CountryID>
<ram:CountrySubDivisionName>Волинська обл. Ковельський р-н</ram:CountrySubDivisionName>
</ram:PostalTradeAddress>
<ram:SpecifiedGovernmentRegistration>
<ram:ID>9864065748694</ram:ID>
<ram:TypeCode>TRADEPARTY_GLN</ram:TypeCode>
</ram:SpecifiedGovernmentRegistration>
</ram:ConsigneeTradeParty>
<ram:CarrierTradeParty>
<ram:ID schemeAgencyID="ЄДРПОУ">12345678</ram:ID>
<ram:Name>Мій Перевізник</ram:Name>
<ram:RoleCode>CA</ram:RoleCode>
<ram:DefinedTradeContact>
<ram:PersonName>Мій водій</ram:PersonName>
<ram:TelephoneUniversalCommunication>
<ram:CompleteNumber>380759876087</ram:CompleteNumber>
</ram:TelephoneUniversalCommunication>
</ram:DefinedTradeContact>
<ram:PostalTradeAddress>
<ram:PostcodeCode>734532</ram:PostcodeCode>
<ram:StreetName>б. 77, вул. Вічна</ram:StreetName>
<ram:CityName>м. Вінниця</ram:CityName>
<ram:CountryID>UA</ram:CountryID>
<ram:CountrySubDivisionName>Вінницька обл. Вінницький р-н</ram:CountrySubDivisionName>
</ram:PostalTradeAddress>
<ram:SpecifiedTaxRegistration>
<ram:ID>3607902</ram:ID>
</ram:SpecifiedTaxRegistration>
<ram:SpecifiedGovernmentRegistration>
<ram:ID>DER453456</ram:ID>
</ram:SpecifiedGovernmentRegistration>
<ram:SpecifiedGovernmentRegistration>
<ram:ID>9864065748793</ram:ID>
<ram:TypeCode>DRIVER_GLN</ram:TypeCode>
</ram:SpecifiedGovernmentRegistration>
<ram:SpecifiedGovernmentRegistration>
<ram:ID>9864065748724</ram:ID>
<ram:TypeCode>TRADEPARTY_GLN</ram:TypeCode>
</ram:SpecifiedGovernmentRegistration>
</ram:CarrierTradeParty>
<ram:NotifiedTradeParty>
<ram:ID schemeAgencyID="ЄДРПОУ">43234323</ram:ID>
<ram:Name>3674_test</ram:Name>
<ram:RoleCode>OB</ram:RoleCode>
<ram:PostalTradeAddress>
<ram:PostcodeCode>468373</ram:PostcodeCode>
<ram:StreetName>вул. МОлода, б.53</ram:StreetName>
<ram:CityName>м. Житомир</ram:CityName>
<ram:CountryID>UA</ram:CountryID>
<ram:CountrySubDivisionName>Житомирська обл., Житомирський р-н</ram:CountrySubDivisionName>
</ram:PostalTradeAddress>
<ram:SpecifiedGovernmentRegistration></ram:SpecifiedGovernmentRegistration>
</ram:NotifiedTradeParty>
<ram:NotifiedTradeParty>
<ram:ID schemeAgencyID="ЄДРПОУ">23462345</ram:ID>
<ram:Name>Мій Експедитор</ram:Name>
<ram:RoleCode>FW</ram:RoleCode>
<ram:PostalTradeAddress>
<ram:PostcodeCode>888888</ram:PostcodeCode>
<ram:StreetName>Новий Ужгород</ram:StreetName>
<ram:CityName>м. Ужгород</ram:CityName>
<ram:CountryID>UA</ram:CountryID>
<ram:CountrySubDivisionName>Закарпатська обл. Ужгородський р-н</ram:CountrySubDivisionName>
</ram:PostalTradeAddress>
<ram:SpecifiedGovernmentRegistration>
<ram:ID>9864065748823</ram:ID>
<ram:TypeCode>TRADEPARTY_GLN</ram:TypeCode>
</ram:SpecifiedGovernmentRegistration>
</ram:NotifiedTradeParty>
<ram:NotifiedTradeParty>
<ram:ID schemeAgencyID="ЄДРПОУ">23232178</ram:ID>
<ram:Name>Мій WH</ram:Name>
<ram:RoleCode>WD</ram:RoleCode>
<ram:PostalTradeAddress>
<ram:PostcodeCode>7728382</ram:PostcodeCode>
<ram:StreetName>Моя Адреса</ram:StreetName>
<ram:CityName>c. Хороша</ram:CityName>
<ram:CountryID>UA</ram:CountryID>
<ram:CountrySubDivisionName>Вінницька обл. Вінницький р-н</ram:CountrySubDivisionName>
</ram:PostalTradeAddress>
<ram:SpecifiedGovernmentRegistration>
<ram:ID>9864232613176</ram:ID>
<ram:TypeCode>TRADEPARTY_GLN</ram:TypeCode>
</ram:SpecifiedGovernmentRegistration>
</ram:NotifiedTradeParty>
<ram:NotifiedTradeParty>
<ram:ID schemeAgencyID="ЄДРПОУ">56523432</ram:ID>
<ram:Name>Мій COP</ram:Name>
<ram:RoleCode>COP</ram:RoleCode>
<ram:PostalTradeAddress>
<ram:PostcodeCode>46234523222</ram:PostcodeCode>
<ram:StreetName>Моя Адреса</ram:StreetName>
<ram:CityName>c. Непереможне</ram:CityName>
<ram:CountryID>UA</ram:CountryID>
<ram:CountrySubDivisionName>Дніпропетровська обл. Криворізький р-н</ram:CountrySubDivisionName>
</ram:PostalTradeAddress>
<ram:SpecifiedGovernmentRegistration>
<ram:ID>9864232613183</ram:ID>
<ram:TypeCode>TRADEPARTY_GLN</ram:TypeCode>
</ram:SpecifiedGovernmentRegistration>
</ram:NotifiedTradeParty>
<ram:CarrierAcceptanceLogisticsLocation>
<ram:ID schemeAgencyID="КАТОТТГ">UA07060170160041154</ram:ID>
<ram:Name>Володя Нова ГЛН</ram:Name>
<ram:TypeCode>10</ram:TypeCode>
<ram:Description>Україна, 456464, Волинська обл. Ковельський р-н, c. Річиця, вул. Атом, буд. 1</ram:Description>
<ram:PhysicalGeographicalCoordinate>
<ram:SystemID schemeAgencyID="GLN">9864065748076</ram:SystemID>
</ram:PhysicalGeographicalCoordinate>
</ram:CarrierAcceptanceLogisticsLocation>
<ram:ConsigneeReceiptLogisticsLocation>
<ram:ID schemeAgencyID="КАТОТТГ">UA07060170160041154</ram:ID>
<ram:Name>Мій Одержувач</ram:Name>
<ram:TypeCode>5</ram:TypeCode>
<ram:Description>Україна, 734532, Волинська обл. Ковельський р-н, c. Річиця, б.145, вул. Зелена</ram:Description>
<ram:PhysicalGeographicalCoordinate>
<ram:SystemID schemeAgencyID="GLN">9864065748694</ram:SystemID>
</ram:PhysicalGeographicalCoordinate>
</ram:ConsigneeReceiptLogisticsLocation>
<ram:DeliveryTransportEvent></ram:DeliveryTransportEvent>
<ram:PickUpTransportEvent>
<ram:CertifyingTradeParty>
<ram:ID schemeAgencyID="РНОКПП">111111111111</ram:ID>
<ram:Name>Post</ram:Name>
<ram:RoleCode>CZ</ram:RoleCode>
<ram:DefinedTradeContact>
<ram:PersonName>Consignor</ram:PersonName>
<ram:MobileTelephoneUniversalCommunication>
<ram:CompleteNumber>380222222222</ram:CompleteNumber>
</ram:MobileTelephoneUniversalCommunication>
<ram:EmailURIUniversalCommunication>
<ram:CompleteNumber>[email protected]</ram:CompleteNumber>
</ram:EmailURIUniversalCommunication>
</ram:DefinedTradeContact>
</ram:CertifyingTradeParty>
</ram:PickUpTransportEvent>
<ram:IncludedSupplyChainConsignmentItem>
<ram:SequenceNumeric>1</ram:SequenceNumeric>
<ram:InvoiceAmount currencyID="UAH">4690</ram:InvoiceAmount>
<ram:GrossWeightMeasure unitCode="KGM">555</ram:GrossWeightMeasure>
<ram:TariffQuantity unitCode="UAH">3</ram:TariffQuantity>
<ram:GlobalID schemeAgencyID="УКТЗЕД">234523</ram:GlobalID>
<ram:NatureIdentificationTransportCargo>
<ram:Identification>Name 1</ram:Identification>
</ram:NatureIdentificationTransportCargo>
<ram:ApplicableTransportDangerousGoods>
<ram:UNDGIdentificationCode>234523</ram:UNDGIdentificationCode>
</ram:ApplicableTransportDangerousGoods>
<ram:AssociatedReferencedLogisticsTransportEquipment>
<ram:ID>Номер контейнера</ram:ID>
</ram:AssociatedReferencedLogisticsTransportEquipment>
<ram:TransportLogisticsPackage>
<ram:ItemQuantity>234</ram:ItemQuantity>
<ram:TypeCode>CT</ram:TypeCode>
<ram:Type>палета</ram:Type>
<ram:PhysicalLogisticsShippingMarks>
<ram:Marking>Назва транспортної упаковки</ram:Marking>
<ram:BarcodeLogisticsLabel>
<ram:ID>34623345</ram:ID>
</ram:BarcodeLogisticsLabel>
</ram:PhysicalLogisticsShippingMarks>
</ram:TransportLogisticsPackage>
<ram:ApplicableNote>
<ram:ContentCode>VENDOR_CODE</ram:ContentCode>
<ram:Content>6234</ram:Content>
</ram:ApplicableNote>
<ram:ApplicableNote>
<ram:ContentCode>BUYER_CODE</ram:ContentCode>
<ram:Content>452345</ram:Content>
</ram:ApplicableNote>
<ram:ApplicableNote>
<ram:ContentCode>QUANTITY</ram:ContentCode>
<ram:Content>2345</ram:Content>
</ram:ApplicableNote>
<ram:ApplicableNote>
<ram:ContentCode>BASE_UOM</ram:ContentCode>
<ram:Content>палета</ram:Content>
</ram:ApplicableNote>
<ram:ApplicableNote>
<ram:ContentCode>PRICE_WITH_VAT</ram:ContentCode>
<ram:Content>2</ram:Content>
</ram:ApplicableNote>
<ram:ApplicableNote>
<ram:ContentCode>SUM_WITHOUT_VAT</ram:ContentCode>
<ram:Content>7035</ram:Content>
</ram:ApplicableNote>
<ram:ApplicableNote>
<ram:ContentCode>NET_WEIGHT</ram:ContentCode>
<ram:Content>11</ram:Content>
</ram:ApplicableNote>
<ram:ApplicableNote>
<ram:ContentCode>RETURN_TARE</ram:ContentCode>
<ram:Content>Зворотня тара</ram:Content>
</ram:ApplicableNote>
<ram:ApplicableNote>
<ram:ContentCode>RTP_TYPE</ram:ContentCode>
<ram:Content>Тип транспортної упаковки</ram:Content>
</ram:ApplicableNote>
<ram:ApplicableNote>
<ram:ContentCode>RTP_QUANTITY</ram:ContentCode>
<ram:Content>42</ram:Content>
</ram:ApplicableNote>
</ram:IncludedSupplyChainConsignmentItem>
<ram:UtilizedLogisticsTransportEquipment>
<ram:ID>bb77767AB</ram:ID>
<ram:SettingTransportSettingTemperature>
<ram:MinimumValueMeasure unitCode="CEL">11</ram:MinimumValueMeasure>
<ram:MaximumValueMeasure unitCode="CEL">22</ram:MaximumValueMeasure>
</ram:SettingTransportSettingTemperature>
<ram:ApplicableNote>
<ram:ContentCode>BRAND</ram:ContentCode>
<ram:Content>auto_from_act_brand</ram:Content>
</ram:ApplicableNote>
<ram:ApplicableNote>
<ram:ContentCode>MODEL</ram:ContentCode>
<ram:Content>auto_from_act_model</ram:Content>
</ram:ApplicableNote>
<ram:ApplicableNote>
<ram:ContentCode>COLOR</ram:ContentCode>
<ram:Content>black_color</ram:Content>
</ram:ApplicableNote>
<ram:ApplicableNote>
<ram:ContentCode>TYPE</ram:ContentCode>
<ram:Content>auto_from_act_type</ram:Content>
</ram:ApplicableNote>
</ram:UtilizedLogisticsTransportEquipment>
<ram:DeliveryInstructions>
<ram:Description>покілометровий тариф</ram:Description>
<ram:DescriptionCode>TRANSPORTATION_TYPE</ram:DescriptionCode>
</ram:DeliveryInstructions>
</SpecifiedSupplyChainConsignment>
</eCMR>
<UaSignatureStorage>
<Signature>
<SigningPartyRoleCode>CZ</SigningPartyRoleCode>
<PartySignature>MIIhZQYJK...r8OD+8LBU5</PartySignature>
<Name>Іванов Іван Іванович</Name>
<Position>1</Position>
<SpecifiedTaxRegistration>
<ram:ID>1234567890</ram:ID>
</SpecifiedTaxRegistration>
</Signature>
</UaSignatureStorage>
</UAECMR>
RESPONSE
В тілі відповіді (json) передається doc_uuid - унікальний ідентифікатор документа на платформі:
{"doc_uuid":"6cd39021-bb80-4eb6-a6f9-03f76a2a9d54"}