е-Фактура API

Познати проблеми со УЈП

На оваа страница се наведува што забележавме дека системот е-Фактура на УЈП го прави во живи тестови, а се разликува од документацијата на УЈП или блокира некој тип на документ. За секоја ставка е наведено што се случува, што прави Merot и што може да направите во меѓувреме. Ставката ја отстрануваме штом УЈП ќе го реши проблемот; промените се наведени и во промените.

УЈП го одбива сторното

Што се случува: секое сторно (POST /v1/einvoices/{id}/storno) УЈП го одбива со E1025 — Invalid void request: Invalid reference for this document type, вратено како HTTP 500. Нашето сторно поле по поле го следи објавениот пример за сторно на УЈП, а истата референца кон оригиналот (неговиот EUID) УЈП ја прифаќа кај книжно задолжение. Тестиравме фактури издадени на самата компанија и на друга компанија, со нов и со оригиналниот идентификатор на документот.

Што прави Merot: сторното завршува со статус invalid, со точната порака од УЈП во lastError и во GET /v1/einvoices/{id}/errors, и со webhook einvoice.ujp_error. Не се испраќа повторно и не бара втор потпис. Оригиналната фактура останува непроменета и важечка кај УЈП.

Во меѓувреме: корекциите (POST /v1/einvoices/{id}/correction) УЈП ги прифаќа и работат нормално.

Книжно одобрение (110) не може да се издаде со даночни индикатори за промет

Што се случува: живиот шифрарник на УЈП што ги поврзува типовите документи со даночните индикатори за книжно одобрение (documentType: "110") дозволува само DDV-22, DDV-24 и DDV-26, додека примерот на УЈП за книжно одобрение користи DDV-A.

Што прави Merot: валидацијата го следи живиот шифрарник на УЈП, па документ 110 со DDV-A (или друг индикатор за промет) се одбива со 422 validation_failed на lines[].taxIndicator, пред да се потпише или испрати. Книжно задолжение (120) УЈП го прифаќа со индикатори за промет и со референца кон оригиналната фактура.

Недокументирани ограничувања на должината на полињата

За некои полиња УЈП не документира максимална должина, но подолгите вредности ги одбива со E4024 … exceeds the character limit. Измерено во живо:

Merot ги применува овие ограничувања во својата валидација (422 пред потпишување), па проблемот го гледате веднаш, а не по потписот.